雲端 Mac 上的 iOS 正則驗證:完整比對與回溯風險
在遠端 Mac 上跑完 iOS 單元測試,表單仍可能接受尾端換行或全形數字,甚至因為一筆過長的輸入而卡住執行緒。問題通常不在機器,而在驗證契約:你檢查的是「找到合法片段」,還是「整個欄位都合法」?以下以固定格式的業務編號建立可重複執行的驗收流程,先確認正確性,再檢查回溯風險。
先將欄位語法定義為契約
假設編號只能由兩個 ASCII 大寫字母、一個連字號和六個 ASCII 數字組成,例如 AB-123456。總長度為九個 UTF-16 碼元,不允許空格、換行或隱含的格式轉換。
先在專案的測試目標中建立合法與不合法的案例,再實作驗證器。不要直接取用正式環境的使用者輸入作為樣本;固定的測試資料更容易重現,也不會將個人資料寫入測試產物。
如果業務規則允許移除前後空格,應將清理設為獨立步驟,分別測試原始輸入與清理後的結果。不要讓驗證函式默默修改內容,否則用戶端、伺服器與稽核紀錄可能會看到不同的編號。
實作真正的完整比對
Foundation 的正則運算式範圍使用 UTF-16,不能直接用 Swift 的 String.count 建立 NSRange。以下實作可以先放進 XCTest 測試檔案,確認行為後再移入業務模組:
import Foundation
import XCTest
private enum TicketCode {
static let pattern = #"\A[A-Z]{2}-[0-9]{6}\z"#
static let regex = try! NSRegularExpression(pattern: pattern)
static func accepts(_ input: String) -> Bool {
guard input.utf16.count == 9 else { return false }
let full = NSRange(input.startIndex..<input.endIndex, in: input)
guard let match = regex.firstMatch(
in: input,
options: [],
range: full
) else {
return false
}
return NSEqualRanges(match.range, full)
}
}
final class TicketCodeTests: XCTestCase {
func testValidationBoundaries() {
let cases: [(String, Bool)] = [
("AB-123456", true),
("ab-123456", false),
("AB-12345", false),
("AB-1234567", false),
("AB-123456\n", false),
(" AB-123456", false),
("AB-123456", false),
("AB-١٢٣٤٥٦", false),
("AB–123456", false),
("🙂AB-123456", false)
]
for (input, expected) in cases {
XCTAssertEqual(
TicketCode.accepts(input),
expected,
"Unexpected result for \(input.debugDescription)"
)
}
}
}
這裡的 try! 僅用於程式碼中固定且經過測試的模式;如果模式來自檔案或設定,應使用可拋出錯誤的初始化方式,並回報設定失敗。正則運算式只編譯一次,避免每次處理輸入時都重新建立物件。
\A 與 \z 明確限定整個字串的開頭與結尾。即使日後調整模式,也應保留完整範圍的比較,避免驗證邏輯退化成子字串搜尋。
補齊 Unicode 與長度邊界
如果欄位只接受 ASCII 數字,請使用 [0-9],不要將 \d 視為等價寫法:Unicode 正則運算式中的數字類別可能包含其他書寫系統的數字。外觀相近的長橫線也不等於 ASCII 連字號,應明確拒絕。
長度規則也必須寫清楚單位。String.count 計算的是延伸字素叢集,UTF-16 長度用於 Foundation 範圍,UTF-8 位元組數則適合用於傳輸配額。這三種計數不能互換;一般備註欄位尤其不能直接套用九個碼元的規則。
測試中應加入空字串、組合字元、歸位與換行序列,以及長度上限兩側的輸入。如果產品需要 Unicode 正規化,應先確定正規化形式,再測試正規化前後是否接受輸入,而不是為了「看起來一樣」就放寬編號語法。
驗證器應拒絕不符合契約的原始輸入。容錯轉換屬於另一層,必須有獨立的規則與測試。
將回溯實驗移出一般測試
不要在一般 XCTest 程序中,以持續增長的輸入挑戰危險模式。像 (a+)+ 這類巢狀重複,在長字串尾端遇到不符合模式的字元時,可能會探索大量候選路徑。某次短樣本執行得很快,並不能證明模式安全。
程式碼審查時,先檢查巢狀量詞、重疊的替代分支,以及不必要的萬用字元。欄位語法若能固定長度,應優先使用明確的字元類別與重複次數;複雜的巢狀格式則應考慮專用剖析器,不要繼續堆疊正則運算式。
對於必須保留的複雜模式,使用獨立的命令列程序執行長度逐步增加的固定樣本。父程序負責控管整體執行期限,逾時後終止子程序並等待其結束;每個長度都另外啟動程序,記錄模式版本、長度、結束狀態與耗時,不記錄敏感的輸入內容。
將工作交給背景佇列,再停止等待結果,不會自動取消正在執行的比對。NSRegularExpression 常用的比對介面沒有可直接設定的硬性執行時限,執行緒隔離也不等於資源隔離。
在遠端 Mac 上建立驗收紀錄
在 VPSPull 的雲端 Mac 上,先記錄 sw_vers 與 xcodebuild -version,再執行包含上述測試的測試目標。保留提交識別碼、模式文字與測試結果,以便區分程式碼變更和系統正則運算式實作的變更。
效能取樣應另外使用固定的建置組態執行,避免測量時同時進行平行建置。門檻應根據相同環境中的重複測量來設定,不要將單次實際經過時間當成通用指標。系統升級後,先重建基準,再判斷是否出現效能退化。
最後確認三件事:合法輸入能完整通過;不合法輸入會在明確的邊界被拒絕;風險實驗不會卡住主要測試程序。入口也應限制請求或檔案大小,因為計算字串長度本身就需要掃描輸入。將這些檢查納入合併驗收,才不會只憑幾筆手動樣本就放行正則運算式的修改。
常見問題
為什麼 firstMatch 回傳結果後還要檢查比對範圍?
firstMatch 可能只找到輸入中的有效片段。驗證整個欄位時,應要求結果範圍等於完整輸入範圍,並使用明確的開頭與結尾約束。
把比對放到背景執行緒並設定逾時,能阻止正則耗盡 CPU 嗎?
不能。停止等待不會自動終止正在執行的 NSRegularExpression 比對。應限制輸入長度、消除危險模式;可疑模式的效能實驗應放在能夠被終止的獨立程序中。