標籤:Go
設定留空或填「*」,安全檢查就悄悄關掉:gortexa 修掉的四個例子
設定留空、填「*」或給自訂清單,可能悄悄關掉安全檢查。gortexa 修掉的四例是 MCP Origin、JWT issuer、OTLP 明文與 secret 遮罩,附 Go 重現。
Secret store 與資料庫的寫入順序:失敗後留下什麼、怎麼接著重試
Secret store 與資料庫若沒有共同交易,寫入順序會影響失敗後留下的狀態。本文用 SQLite 示範覆寫風險、pending 與重試,並說明這個範例為何無法使用 2PC。
讓 .proto 當唯一契約來源:Go 單一 port 同時服務 gRPC 與 HTTP/JSON 的做法與代價
讓 .proto 成為唯一契約來源,型別與各個入口都從它產生。本文用 Go 範例示範 gRPC 與 HTTP/JSON 共用 h2c port 和共用 timeout 的代價,並以 gortexa 說明 MCP 的接法。
ClickHouse 寫入怎麼批次:queue 加 Go worker、async insert 與重試去重
ClickHouse 寫入用 queue 加 Go worker 累積 batch,大小與時機最好掌控;無法自行累積時可用 async insert,重試則靠去重。Replicated 表更新別用 now(),附 26.9 實測。
RFC 10017 之後,BFF 的第一個理由是 token 不進瀏覽器
RFC 10017 把 BFF 列為瀏覽器應用最安全的 OAuth 架構,token 由伺服器保管。設計時先決定 token 放哪,再談聚合,文中以 Go 標準庫示範最小實作。
遊戲 RNG 正式環境要猜不到、測試要能重播:在 Go 裡把兩件事切開
遊戲邏輯透過 Source 介面接上不可推導的正式來源,測試用 HMAC 推導 seed 給 ChaCha8,爭議重播記錄每局原始值。文中重現 AES-CTR 套件重複上鎖的 deadlock,並比較修法。
HMAC 請求簽章該簽哪些東西:method、path、query 與 body 的原始 bytes
只簽 body 的 HMAC,換掉 path 或 query 照樣驗過;重新序列化 JSON 再驗,合法請求反而失敗。簽章要涵蓋 method、path、排序後的 query 與 body 原始 bytes,附 Go 1.27 實測。
沒設定就當成零:預設硬上限、four-eyes 門檻與 kill switch 故障方向
上限、門檻和 kill switch 的預設值,決定設定漏掉或來源壞掉時系統會怎麼走。金額超出精度直接拒絕、four-eyes 門檻未設定視為 0、kill switch 讀不到時錢的寫入停下、查詢照常,附 Go 1.27 範例。
沒實作的六件事:從框架學到什麼
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 框架。當目標從單一微服務的輕量化轉向跨服務的一致性與治理,框架層選擇集中複雜度,用維護負擔換強制一致、內建可觀測性與依賴集中管理。
記憶體與併發原語
零分配靠三件事:逃逸分析決定變數落在 stack 還是 heap,sync.Pool 重用短命物件攤平 GC,同步原語單值用 atomic、一塊狀態用 Mutex、讀遠多於寫才用 RWMutex。
goroutine 與 channel
goroutine 便宜但會 leak,channel 自帶同步語意,讓一個 goroutine 獨佔狀態就不用鎖,但純計數與小塊狀態用 mutex 或 atomic 更簡單,別迷信 channel。
interface 與組合
Go 的 interface 隱式滿足,型別有方法就算數,小介面加 embedding 取代繼承,對介面寫程式配 adapter 就能抽換實作,gortex 換 OTel tracing 就是例子。
struct tag 與 reflect
struct tag 靠 reflect 在執行期讀,Lookup 分得出空值與沒掛的 tag,reflect 會 panic 又慢,只在啟動期用,別進 hot path,這是宣告式路由的地基。
net/http 與 middleware 模式
多數 Go web 框架(Gin、Echo、chi)都長在 net/http 上,http.Handler 與 ServeHTTP 是唯一的抽象,middleware 就是包一層 Handler 的閉包,外層先跑。