JWT验签失败“signature is invalid”主因是签名算法与密钥类型不匹配或密钥含不可见字符；应确保alg声明、SigningMethod、密钥类型严格一致，用jwt.ParseWithClaims绑定自定义claims，设置合理time skew，并通过kid而非alg查密钥以防范篡改。
为什么 jwt.Parse 返回 ValidationError: signature is invalid
这通常不是密钥没配对，而是签名算法和密钥类型不匹配。比如用 HS256 签名却拿 RSA 公钥去验，或密钥字符串里混入了不可见字符（如换行、BOM）。golang-jwt 默认严格校验算法声明（alg 字段），且不自动 trim 密钥。
- 检查 JWT header 中的
alg值是否与你调用jwt.Parse时传入的SigningMethod一致（如jwt.SigningMethodHS256） - 密钥必须是原始字节切片，不要用
strings.TrimSpace后再转[]byte—— 某些环境（如 K8s ConfigMap）会注入尾部换行，直接用strings.TrimRight(key, "\n\r")更安全 - 若用 RSA，确保私钥用于签发、公钥（PEM 格式）用于验证，且公钥必须以
-----BEGIN PUBLIC KEY-----开头
如何正确使用 jwt.ParseWithClaims 提取并校验 payload
别直接用 jwt.Parse，它只返回通用 *Token，字段访问容易 panic。用 jwt.ParseWithClaims 绑定自定义结构体，让解析 + 类型断言一步完成。
- 自定义 claims 结构体必须嵌入
jwt.RegisteredClaims（不是旧版的jwt.StandardClaims） - 验证时显式传入
jwt.Keyfunc，而不是固定密钥 —— 这样才能支持多密钥轮换或不同算法混合 - 务必检查
err == nil && token.Valid，因为ParseWithClaims即使解析成功也可能因过期/签名失败返回token.Valid == false
type MyClaims struct {
Userid int `json:"userid"`
jwt.RegisteredClaims
}
<p>token, err := jwt.ParseWithClaims(tokenString, &MyClaims{}, func(token <em>jwt.Token) (interface{}, error) {
return []byte(secretKey), nil // HS256
})
if err != nil || !token.Valid {
return nil, fmt.Errorf("invalid token: %w", err)
}
claims := token.Claims.(</em>MyClaims)
如何避免 time.Now().Unix() 和 JWT 时间戳偏差导致验签失败
JWT 的 exp、nbf 是秒级时间戳，但 Go 的 time.Now().Unix() 在高并发下可能因系统时钟抖动或容器纳秒级时间精度，造成 ±1 秒误差。更糟的是，某些 JWT 库（包括老版本 github.com/dgrijalva/jwt-go）默认允许 1 秒 skew，而新 golang-jwt 默认为 0。
- 生产环境务必设置
jwt.WithValidatioTimeFunc，例如允许最多 2 秒偏差：jwt.WithValidatioTimeFunc(func(t time.Time) time.Time { return t.Add(2 * time.Second) }) - 不要在 token 生成时用
time.Now().Add(...).Unix()，改用time.Now().Add(...).Truncate(time.Second).Unix()，避免纳秒残留影响比较 - 如果服务部署在多个时区或 NTP 不同步的节点上，考虑统一用 UTC 时间生成 token，并在验证前强制转为 UTC
为什么 jwt.SigningMethodHS256 不能和 jwt.SigningMethodRS256 共用同一个 Keyfunc
Keyfunc 被设计为动态返回密钥，但如果你在函数里硬编码判断 token.Method.Alg() == "HS256" 就返回 []byte，而 "RS256" 就返回 *rsa.PublicKey，看似合理，实则危险：一旦攻击者篡改 header 的 alg 为 none 或 HS256 并伪造签名，Keyfunc 可能返回错误类型密钥，导致验签逻辑绕过。
立即学习“go语言免费学习笔记（深入）”；
- Keyfunc 必须根据 token header 中可信来源（如 issuer 或 kid）查密钥，而不是仅靠
alg字段 —— 因为 alg 可被篡改 - 明确拒绝
none算法：if token.Method.Alg() == "none" { return nil, jwt.ErrInvalidKeyType } - 对每个 issuer 配置独立密钥集，kid 字段应映射到具体密钥实例，而非算法类型
实际用起来最麻烦的不是语法，是密钥生命周期管理——轮换时旧 token 还在流通，新密钥已上线，Keyfunc 得能同时加载新旧密钥并按 kid 匹配；而时间 skew 设置太松会延长攻击窗口，太紧又导致合法用户频繁掉线。这些细节不写进代码注释，上线后就得靠日志反复试错。
