签名中间件必须按路由绑定，不能全局注册，否则/healthz等免鉴权路径会返回401；需显式串联authmiddleware，缓存并复用req.body，限制body大小，跳过multipart请求校验，联合校验时间戳与nonce防重放，使用hmac.equal和标准hmac实现。
签名中间件必须按路由绑定，不能全局注册
全局注册 authMiddleware 会导致 /healthz、/metrics、/static/ 等路径全部 401——因为这些请求根本不带 X-Signature 和 X-Timestamp。正确做法是只对明确需鉴权的接口启用：
- Gin：用
router.POST("/api/order", authMiddleware, orderHandler)显式串联 - Chi：用
r.Post("/api/order", authMiddleware(orderHandler))，其中authMiddleware返回http.Handler - 原生
net/http：避免http.Handle("/", ...)，改用http.Handle("/api/", ...)，并在 handler 内部做前缀判断
req.Body 必须缓存复用，否则下游读不到数据
req.Body 是单次可读流。中间件调用 io.ReadAll(req.Body) 后，后续业务 handler 再读就是空字节，json.NewDecoder(r.Body).Decode(&v) 直接返回 EOF。
- 先用
io.ReadAll读出原始字节b - 立即重置：
req.Body = io.NopCloser(bytes.NewReader(b)) - 用
b计算 HMAC，同时留给下游解析 - 务必加限制：
http.MaxBytesReader(w, r, r.Body, 2（例如 2MB），防恶意大 body 耗尽内存 - 对
multipart/form-data请求应直接跳过签名校验——multipart解析本身就会消费req.Body，且签名无意义
时间戳 + nonce 必须联合校验，单靠时间窗口是漏洞
只检查 abs(now.Unix()-ts) 允许攻击者在 5 分钟内无限重放同一请求。必须引入唯一性约束：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 客户端传
X-Nonce: abc123，服务端存入 Redis 或本地 LRU cache，TTL 设为略大于时间窗口（如 310 秒） - cache key 推荐格式：
"sig:nonce:" + userID + ":" + nonce，防跨账号碰撞 - 时间戳单位统一用秒（
time.Now().Unix()），拒绝毫秒值（客户端时钟精度不一致易误判） - 额外防御：
if req.Timestamp > time.Now().Add(2 * time.Minute).Unix() { return false }，防客户端时间严重超前
HMAC 必须用标准实现，禁止手拼 secret+data
sha256.Sum256([]byte(secret + data)) 是高危操作——它暴露于长度扩展攻击，攻击者可在不知 secret 的情况下伪造合法签名。
- 必须用
hmac.New标准构造：h := hmac.New(sha256.New, []byte(secret))，再写入data - 比对必须用
hmac.Equal，而非==，防时序攻击 - secret 不应硬编码，建议从环境变量或配置中心加载
- 签名字符串拼接顺序必须严格约定（如：method + path + sorted_query_string + timestamp + nonce + body_sha256），前后端完全一致
实际组装时，最易被忽略的是 req.Body 复用和 nonce 去重存储的耦合点——这两处一旦漏掉，要么下游解码失败，要么重放防护形同虚设。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
