JWT验证中间件必须处理时钟偏移和kid路由：默认ParseWithClaims严格校验exp/nbf易因时钟不同步误拒，需用jwt.WithValidator实现±30秒宽松校验；keyFunc须依kid查密钥映射，缺kid时返回nil和错误而非panic；签名中间件须防重放、防篡改、防body重复读，绑定时间戳、nonce并重新拼参验签。
JWT 验证中间件必须处理时钟偏移和 kid 路由
默认用 github.com/golang-jwt/jwt/v5 的 ParseWithClaims 会严格校验 exp 和 nbf，但生产环境服务器与客户端时钟不同步很常见，直接导致合法请求被拒。
- 必须显式传入
jwt.WithValidator，自行实现宽松时间校验，例如允许 ±30 秒偏差 - 密钥轮换时，
keyFunc不能只返回一个密钥；要根据token.Header["kid"]路由到对应密钥，未提供kid时应返回nil, errors.New("missing kid")，而非 panic - 别在
keyFunc里硬编码密钥字符串——从配置中心或环境变量加载，并加读取失败兜底逻辑
签名验证中间件要防重放、防篡改、防 body 重复读取
单纯比对 X-Signature 头不等于安全。签名必须绑定时间戳、随机 nonce 和完整参数，且服务端需做三件事：校验时间窗口、查重 nonce、重新拼参计算签名。
- 时间戳校验建议用
time.Now().Unix() - timestamp <= 300（5 分钟），单位统一为秒，避免纳秒/毫秒混淆 - nonce 需存 Redis 并设 TTL（略大于时间窗口），防止被复用；注意 Redis key 命名要带 client ID，避免跨账号冲突
- 签名计算前必须调用
c.Request().Body一次并缓存结果，否则后续 handler 再读就是空的；可用io.TeeReader或 Gin 的c.Copy()实现
Logger 和 Recovery 中间件的审计级配置
日志不是记下来就行，没关键字段的日志在攻防溯源时等于废纸；panic 捕获也不是打个 log 就完事，响应体泄露才是大忌。
- Logger 必须补全三项：
RequestID（全局链路追踪）、User-Agent（识别爬虫/异常客户端）、BodyHash（SHA256 哈希，非明文落盘）；ctx.Body()前得先调c.Request().DisableBodyConsumption() - Recovery 中间件开启堆栈后，
StackTraceHandler函数里绝不能调c.Writer.Write()或c.Header().Set("Content-Type", ...)，否则 panic 信息可能混进响应体；推荐在 handler 结尾显式调c.Writer.Reset() - 所有中间件顺序不能乱：logger → recovery → auth → signature → rate limit → business，错一位就可能漏审计或泄敏感信息
govulncheck 扫描出高危 CVE 后怎么安全降级
直接 go get xxx@v1.2.3 很可能破坏依赖兼容性，尤其涉及 crypto 或 net/http 相关模块时。
立即学习“go语言免费学习笔记（深入）”；
- 先运行
go list -u -m all | grep xxx确认官方是否已发布修复版本；若没有，查该 CVE 对应的 Go 提交哈希（如golang/go@abc1234） - 用
replace在go.mod中强制指定安全提交，并加// CVE-2025-XXXXX: fix in golang/go@abc1234注释 - 降级后必须跑全流程测试，特别是 HTTPS 请求、JWT 解析、HMAC 签名生成——这些路径最容易因底层 crypto 行为变更而静默失败
真实线上问题往往卡在细节：比如 BodyHash 没做导致审计无法确认请求体是否被篡改，或者 kid 路由缺失让密钥轮换上线即炸。安全不是加一堆中间件就完事，是每个环节都得想清楚“它在什么条件下会失效”。
