golang-jwt解析token报panic: invalid character，主因是传入非法字符串（如空值、截断token或含bearer前缀）；须手动trimspace、cutprefix、校验三段式后再parse。
golang-jwt 库解析 token 时 panic: invalid character 错误
这是最常见的开局报错，本质是传入了非法字符串——比如空值、被截断的 token、或混入了 HTTP 头部（如 Bearer eyJ...）。Parse 不会自动 trim 或切前缀，必须手动处理。
实操建议：
- 先用
strings.TrimSpace清除首尾空白 - 检查是否带
Bearer前缀：用strings.CutPrefix(token, "Bearer ")安全剥离，别直接strings.Split或硬切索引 - 确保 token 是完整三段式（
xxx.yyy.zzz），可用strings.Count(token, ".") == 2快速过滤 - 不要在未校验格式前就丢给
Parse，否则 panic 无法 recover
jwt.ParseWithClaims 里 SecretKey 类型不匹配导致签名验证失败
golang-jwt v4+ 强制要求密钥类型与签名算法严格对应。用 HS256 却传 []byte 没问题，但若用 RS256，就必须传 *rsa.PrivateKey / *rsa.PublicKey，传 []byte 会静默失败或 panic。
实操建议：
- HS 系列（HS256/HS384/HS512）：密钥必须是
[]byte，推荐用[]byte(os.Getenv("JWT_SECRET")) - RS 系列：用
jwt.WithPublicKey或jwt.WithPrivateKey显式指定，别试图把 PEM 字符串直接当 key 传 - 验证前先确认 token header 中的
alg字段，可用jwt.ParseUnverified先读 header，再选对应 verifier - 错误现象：返回
ErrSignatureInvalid却没其他提示——大概率是 key 类型或算法不匹配
自定义 Claims 结构体字段无法反序列化
Go struct 字段没加 JSON tag，或 tag 名和 JWT payload 字段名不一致，会导致 Claims 解析后字段为空。尤其注意大小写：JWT 标准字段如 exp、iat 是小写，Go 字段名却常写成 Exp、Iat。
实操建议：
- 所有需要解析的字段必须加
json:"exp"这类 tag，且值与 JWT payload 中 key 完全一致（包括大小写） - 标准字段建议嵌入
jwt.RegisteredClaims，它已预置好正确 tag 和类型（如ExpiresAt *jwt.NumericDate） - 自定义字段如
user_id，struct 中要写UserID string `json:"user_id"`，不能只靠首字母大写自动映射 - 如果用了指针字段（如
*string），解析失败时不会报错，只是值为 nil——务必检查非空
token 过期时间验证失效或时区偏差
exp 验证失败却不报错？常见原因是没传 jwt.WithValidator 或漏掉 VerifyExpiresAt。golang-jwt 默认不校验过期，必须显式启用；且系统时间与签发方时间不同步时，exp 判断会失准。
实操建议：
- 必须用
jwt.WithValidators(jwt.ExpectedTimeValidator(time.Now().UTC(), 5*time.Second))启用时间校验（第二个参数是可容忍的时钟偏差） - 所有时间操作统一用
time.UTC，避免本地时区干扰 - 别依赖
claims.ExpiresAt.Time手动比对，交给库的 validator 做，它会处理NumericDate转换和边界逻辑 - 调试时打印
claims.ExpiresAt.Unix()和time.Now().Unix()对比，确认偏差是否超阈值
最易忽略的是：token 解析成功 ≠ 验证通过。解析只做 base64 解码和结构检查，签名、过期、签发者等全靠后续显式调用 validator。漏掉任一环节，都可能让非法 token 浑水摸鱼。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
