如何為缺乏單元測試的十年老系統建立特徵測試防護網

在我們參與過的台灣企業代碼審查專案中，超過七成的遺留系統（Legacy Systems）存在著相同的困境：核心業務邏輯深埋在數千行的巨型函式中，既無架構文件，亦無自動化測試。開發團隊每當接獲業務新需求，修改時無不如履薄冰，深怕觸發未知的隱性連鎖錯誤。

許多工程主管的第一直覺是「要求團隊補寫單元測試」。然而，在高度耦合的代碼結構下，若無先進行依賴解耦，往往連實例化物件都困難重重。此時，強行撰寫單元測試只會陷入必須 Mock 幾十個無關依賴的痛苦深淵。

更務實的破局策略是採用「特徵測試」（Characterization Testing，亦稱 Golden Master 測試）。特徵測試的核心哲學不是驗證代碼『應當做什麼』，而是忠實記錄代碼『目前實際上在做什麼』。我們將遺留模組視為一個黑盒，輸入大量的邊界樣本、歷史交易資料與真實請求參數，並完整擷取其輸出狀態與資料庫副作用。

建立特徵測試的具體步驟如下：首先，在外部呼叫邊界處插入攔截點，自動記錄真實流量下的輸入輸出配對；其次，將這批紀錄持久化為基準測試案例庫；第三，在進行任何代碼重構或函式抽離時，於 CI 流水線中持續比對輸出結果是否與基準完全一致。只要輸出產生了即使僅 1 位元的偏差，防護網便會即時警報。

藉由特徵測試的保護，團隊不再需要依賴盲目的運氣與繁瑣的人工回歸測試。工程師得以在明確掌握安全邊界的前提下，大膽進行函式萃取（Extract Method）、常數命名替換與死代碼清理，逐步將僵化的老舊代碼庫引導回可維護的正軌。