签名校验中间件必须绑定到具体路由而非全局注册，否则健康检查等非业务请求会因缺失签名头返回401；需在路由匹配后、业务逻辑前执行，并缓存复用req.body以避免下游读取为空。
签名校验中间件必须绑定到具体路由，不能全局注册；否则健康检查、静态资源等非业务请求全被拦截，401泛滥。
中间件必须在路由匹配后、业务逻辑前执行
Go 的 http.Handler 链中，签名验证不是越早越好。放在 http.ListenAndServe 前或全局 Use() 里，会导致 /healthz、/metrics、前端 /static/ 等路径也进校验逻辑——而它们根本不带 X-Signature 或 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 内部做路径前缀判断
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 防止恶意大 body 耗尽内存
注意：对 multipart/form-data 或文件上传请求，应跳过签名（直接放行），因为 multipart 解析本身就会消费 req.Body，且签名无意义。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
时间戳 + nonce 必须联合校验，单靠时间窗口不够
只检查 abs(now.Unix()-ts) 是典型漏洞——攻击者可重复发送同一合法请求，在 5 分钟内无限重放。
必须引入唯一性约束：
- nonce 字段从客户端传入（如
X-Nonce: abc123），服务端存入 Redis 或本地 LRU cache，TTL 设为略大于时间窗口（如 310 秒） - cache key 推荐格式：
"sig:nonce:" + userID + ":" + nonce，防跨账号碰撞 - 时间戳单位统一用秒（
time.Now().Unix()），拒绝毫秒值（客户端时钟精度不一致易误判） - 额外防御：拒绝
req.Timestamp > time.Now().Add(2 * time.Minute).Unix()的请求，防客户端时间严重超前
HMAC 必须用标准实现，禁止手拼 secret+data
写 sha256.Sum256([]byte(secret + data)) 是高危操作——它暴露于长度扩展攻击，攻击者可在不知 secret 的前提下伪造签名。
必须使用 crypto/hmac：
- 初始化：
h := hmac.New(sha256.New, []byte(secret)) - 写入：
h.Write([]byte(payload))，payload 顺序必须与客户端严格一致（如method + uri + timestamp + md5(body)） - 比对用
hmac.Equal(sig1, sig2)，防止时序攻击 - secret 必须来自服务端配置或密钥管理服务，绝不可从请求头或参数读取
调试时可在中间件开头加日志打印脱敏后的 payload（如截取前 100 字符），方便和客户端对齐签名原文。
最常被忽略的是：错误响应体必须结构化且区分原因——4001（格式错）、4002（时间超时）、4004（签名不匹配）不能全塞进 401 Unauthorized；否则客户端无法精准重试或上报问题。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
