JWT签名校验失败等安全问题根源在于校验逻辑未守住边界：必须用jwt.ParseWithClaims配keyFunc，首行校验token.Method.Alg()并拒绝非法算法，禁止未验签就读header字段，严格校验iat/exp并容忍时钟偏差，错误响应需脱敏且清理上下文。
JWT 签名校验失败、header 被篡改成 none、客户端伪造过期时间却没被拦住——这些问题不是密钥配错了，而是签名校验逻辑本身没守住边界。防篡改不是“加个 token 就完事”，关键在三段式校验的每个环节都必须显式约束。
jwt.ParseWithClaims 必须配 keyFunc，不能用无参数的 Parse
直接调用 jwt.Parse 会跳过算法匹配和密钥动态选择，导致两个致命问题：一是 header 中声明 HS256，但服务端用 HS512 密钥去验，必然报 signature is invalid；二是攻击者把 header 改成 {"alg":"none"}，旧版 jwt-go v3 会静默接受，v4+ 虽默认禁用，但若没配 keyFunc，仍可能绕过校验路径。
实操建议：
-
keyFunc必须返回密钥，且第一行就检查token.Method.Alg()，不匹配直接返回nil和错误，例如只允许HS256 - 不要从
token.Header["kid"]查密钥再验证——kid 是 header 一部分，未验证前不可信；应先完成签名验证，再读取 payload 中可信字段（如iss、sub）做业务判断 - 在
keyFunc里加日志，打印token.Header["alg"]和token.Method.Alg()，上线初期能快速发现 header 被篡改的请求
Gin 中间件里 c.AbortWithStatusJSON 的响应要隔离错误细节
鉴权失败时返回 401 Unauthorized 是对的，但若响应体里带 "token is invalid: signature is invalid" 这类底层错误，等于告诉攻击者你用的是 JWT、用的是什么库、甚至算法类型。更危险的是，有些中间件在 abort 前没清理 context，导致后续 handler 误读残留数据。
实操建议：
- 统一用封装好的
Fail(c, http.StatusUnauthorized, 40001, "登录已失效")类函数，业务错误码和用户提示分离，不暴露技术细节 - abort 前调用
c.Request.Body.Close()（尤其当 body 已被读取过），避免连接复用时脏数据污染 - 不要在中间件里直接写
c.JSON(401, gin.H{...})，而应走项目级错误响应标准，确保 Content-Type 是application/json; charset=utf-8，且无额外 header 泄露
payload 时间字段必须双重校验：iat/exp + 服务器时钟容忍度
JWT 的 exp 和 iat 是 Unix 时间戳，但客户端时间可随意修改。常见错误是只依赖 jwt.WithExpirationRequired()，结果攻击者把手机时间拨到一年后，token 永远不过期。
实操建议：
- 解析后手动检查
claims.IssuedAt.Time.After(time.Now().Add(5 * time.Minute))，拒绝未来过久签发的 token（比如 >5 分钟） - 设置服务器时钟容忍窗口，例如
jwt.WithTimeFunc(func() time.Time { return time.Now().UTC().Add(-30 * time.Second) })，抵消 NTP 同步偏差 - 不在 payload 存敏感业务字段（如权限列表），只存
user_id，权限查数据库或 Redis，避免 payload 被解码后直接滥用
最易被忽略的一点：所有校验逻辑必须在 keyFunc 返回密钥前完成——包括算法白名单、kid 格式校验、甚至 IP 绑定检查。因为 jwt-go 的验证流程是「先找密钥 → 再验签名」，密钥获取阶段就是第一道防线，不是签名之后才开始的。
