標籤:Gortex
沒實作的六件事:從框架學到什麼
gortex 刻意沒做的六件事:完整 graceful shutdown、middleware 錯誤語意、組態熱更新、請求級 timeout、結構化錯誤、OpenAPI 產生,每件都難在生產級細節。
安全中介層全家桶:CORS / CSRF / JWT / rate limit / binder
gortex 在框架層整合 body 上限、CORS、CSRF、JWT、rate limit 與 log 遮蔽:JWT 鎖定 HS256,在 proxy 後按 IP 做 rate limit 要配 TrustedProxies。
可觀測性:三態健康檢查與 tracing 抽象層
gortex 的三態健康檢查比 up/down 多一個降級狀態,tracing 只依賴 Tracer 介面,OTel 當 adapter 接上,要產生 OTel span 得改用 adapter 自己的方法。
WebSocket Hub:Go 版 Actor 模型
gortex 的 WebSocket Hub 是 Go 版 actor 模型:狀態只由單一 goroutine 持有,外部透過 channel 送請求,用通訊取代鎖,慢消費者滿了就丟。
併發計數與韌性:sharded metrics 與 circuit breaker
gortex 用 FNV hash 把鎖拆成 16 片、高頻計數走 atomic,circuit breaker 是三態機,這裡用 atomic 與 mutex 比 channel 直接。
零分配的秘密:Context pool 與 smartParams
gortex 路由零分配的三個手法:sync.Pool 重用 Context、[4]string 的 smartParams、內嵌 responseWriter,再用 benchmem 驗證。
Segment-trie 路由器:不靠正則的匹配
gortex 的 segment-trie 路由器不靠正則,每次請求只做字串切割加 map 查詢,不需回溯時比對成本 O(segments),Static、Param、Wildcard 依序比對並支援回溯。
Struct tag 宣告式路由:reflect 實戰
gortex 用 reflect 在啟動時掃 handler struct 的 tag 自動發現路由表,方法名決定 HTTP method,middleware 沿群組繼承,設定錯誤在啟動期就報錯。
為什麼造一個 kitchen-sink 框架
gortex 是研究用的 kitchen-sink 框架。當目標從單一微服務的輕量化轉向跨服務的一致性與治理,框架層選擇集中複雜度,用維護負擔換強制一致、內建可觀測性與依賴集中管理。