Go 1.27 升級指南：泛型方法、JSON v2 同洩漏排查逐樣睇
正式版已經推出，backend 團隊升級前最好先跑兼容測試
Go 官方嘅 release history 已列明 Go 1.27.0 喺 2026 年 8 月 19 日推出，發布狀態冇懸念。今次更新睇落有語言功能、JSON、runtime 效能同診斷工具幾條線，但對 backend 服務最直接嘅影響其實幾集中：新 API 可以寫得乾淨啲，舊 JSON 程式大致照行，不過測試唔可以慳。
泛型方法令 API 順手，但有清楚界線
Go 1.18 加入泛型之後，泛型函式一直只可以放喺 package 層。Go 1.27 終於容許 method 自己宣告 type parameter，例如 math/rand/v2 而家有 Rand.N，同一個 receiver 可以處理唔同整數類型。對 collection、parser、builder 呢類 API，相關操作可以收返入個 type 嘅 namespace，亦少咗一堆為唔同類型改名嘅函式。不過 官方 release notes 寫得好清楚：interface method 仍然唔可以宣告 type parameter，generic method 亦唔可以用嚟實作 interface method。換句話講，呢次最受惠係具體 type 嘅工具 API，依賴 interface contract 嘅架構唔會突然大改玩法。
JSON v2 先由輸入輸出邊界試起
encoding/json/v2 同較底層嘅 encoding/json/jsontext 已進入標準函式庫。v2 預設嚴格過舊版，會拒絕重複 object key 同無效 UTF-8；field 名改用大小寫精確配對，nil slice、nil map、omitempty、map 輸出次序等行為亦有差異。官方遷移文件 列出嘅差別相當長，所以直接全域換 import 風險唔細，尤其係食第三方 webhook、舊客戶 payload，或者測試會逐字比較 JSON 嘅服務。
舊 encoding/json 而家底層改用 v2 implementation，不過預設行為仍然跟 v1 semantics，官方亦承諾會繼續支援舊 API。一般程式毋須即刻搬，最易浮面嘅差異反而係 error message 文字；如果測試或者監察規則硬食錯誤字串，就值得先改成檢查 error type 或結果。真係撞到 implementation 兼容問題，1.27 暫時可以喺 build 時設 GOEXPERIMENT=nojsonv2 退返舊 implementation，不過官方話呢個出口日後會移除，適合救急，唔適合長期當設定。
「最高快 30%」去到完整程式，官方估計約 1%
iThome 報道將 30% 放入標題，但 Go 官方數字 指向嘅範圍好窄：compiler 會為部分細過 80 bytes 嘅物件呼叫按大小特化嘅分配 routine，嗰一次分配成本最高低 30%。官方估計連 allocation-heavy 嘅真實程式，整體改善都大約得 1%，binary 仲會固定大約 60KB。呢項優化係免費小進帳，唔應該當容量規劃依據；升級前後照跑自己嘅 benchmark、allocation profile 同延遲分位數，先睇得出服務有冇着數。
goroutineleak 終於可以直接放入排查流程
Go 1.26 要開 experiment 先有嘅 goroutineleak profile，1.27 已轉正式功能。開咗 net/http/pprof 嘅服務可以查 /debug/pprof/goroutineleak，程式內亦可以用 runtime/pprof.Lookup("goroutineleak")。runtime 會靠可達性分析，搵出卡喺 channel、mutex 或 condition variable，而且已冇可能再醒返嘅 goroutine。呢個 profile 可以快過普通 goroutine dump，幫手收窄真正洩漏嘅範圍，但佢睇唔晒所有情況：同步物件如果仍俾 global variable，或者可執行 goroutine 嘅 local variable 引用住，runtime 可能判斷唔到。長跑 API、worker 同訊息處理服務可以將佢加落 staging、壓力測試同事故排查，pprof endpoint 就繼續放喺受限網絡，唔好直接公開。
升級次序由兼容測試帶路
現有 Go 團隊可以先用 1.27 重建服務，保留 encoding/json import，跑齊 golden test、外部 API contract test 同錯誤處理測試；跟住揀一兩個邊界清楚嘅 component 試 encoding/json/v2，逐項決定要 v2 預設定舊 semantics。泛型方法適合喺新 API 慢慢採用，冇必要為改寫而改寫。效能數字留返畀 benchmark 判斷，而 goroutineleak profile 就值得及早接入診斷流程，呢項通常快過追逐嗰個 30% 上限幫到長跑服務。
參考來源
- iThome — Go 1.27加入泛型方法與JSON v2，小型物件配置成本最高降30% — original report
- Go 1.27 Release Notes — 核實泛型方法限制、JSON v2、分配效能數字同 goroutineleak 正式狀態
- Go Release History — 核實 Go 1.27.0 喺 2026 年 8 月 19 日正式發布
- encoding/json：Migrating to v2 — 官方列出 v1、v2 預設行為差異同漸進遷移選項
- Go 1.26 Release Notes — 交代 goroutineleak 由實驗功能走到正式版嘅背景同偵測限制
本文根據原文及公開資料整理；資料有出入時，以原文及官方資料為準。
