旧版jwt在echo中解析失败主因是echo-jwt/v4默认拒绝alg:none、不校验exp且要求字段完整；需在keyfunc中显式拦截none算法、传withvalidtimefunc容错时钟偏差、手动补exp/iss等缺失字段，并标准化base64url解码。
旧版 JWT 令牌在 Echo 中解析失败，大概率是签名算法、时间校验或字段缺失导致的——不是框架不兼容，而是 echo-jwt/v4 默认行为更严格，必须显式适配。
echo-jwt/v4 默认拒绝 alg:none 和过期时间不校验
旧系统签发的 token 常用 alg: none 或忽略 exp 字段，而 echo-jwt/v4 的 jwt.ParseWithClaims 底层默认不校验时间、且会直接 panic 掉 alg: none。你不能靠“降级到 v3”解决，得改配置。
- 在
echojwt.Config.KeyFunc中显式拒绝非预期算法：if token.Header["alg"] == "none" { return nil, errors.New("alg none not allowed") } - 必须传
jwt.WithValidTimeFunc，否则exp字段被完全跳过；推荐用func(t time.Time) bool { return t.After(time.Now().Add(-5 * time.Second)) }容忍时钟漂移 - 如果旧 token 没设
exp，需在KeyFunc返回密钥前手动补：claims := token.Claims.(jwt.MapClaims); if _, ok := claims["exp"]; !ok { claims["exp"] = time.Now().Add(24 * time.Hour).Unix() }
旧 token 缺少 jti、iss、aud 导致 c.Get("user") 为空
echo-jwt/v4 解析后只把 *jwt.Token 放进 context，但很多老代码依赖 c.Get("user").(*User)，这需要你手动从 token.Claims 构建对象并塞入 context，不能指望中间件自动做。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 别依赖
echojwt.Config.ContextKey直接存*jwt.Token，改用自定义中间件包装：return func(c echo.Context) error { ... user := &User{ID: int(claims["sub"].(float64))}; c.Set("user", user); return next(c) } - 若旧 token 用
sub存用户 ID，但值是字符串（如"123"），注意类型断言：claims["sub"].(string)而不是float64 - 如果旧系统没写
iss或aud，jwt.ParseWithClaims不会报错，但你的业务逻辑可能因claims["iss"] == nilpanic，务必加空值判断
Base64Url 编码不一致引发 signature invalid
某些旧 PHP 或 Python JWT 库生成 token 时未严格按 RFC 7515 补齐等号或处理换行，导致 Go 的 base64.RawURLEncoding.DecodeString 解码失败。错误信息通常是 illegal base64 data at input byte X。
- 不要在
KeyFunc里直接解码 token.Raw，先标准化：raw := strings.ReplaceAll(token.Raw, "-", "+"); raw = strings.ReplaceAll(raw, "_", "/"); raw += strings.Repeat("=", (4-len(raw)%4)%4) - 或者改用
base64.URLEncoding.DecodeString（带填充）而非RawURLEncoding，它能容忍缺失等号 - 验证环节别只看
token.Valid，要拆开检查：token.Signature == "" || len(token.Signature) 可快速过滤明显畸形 token
兼容旧 token 最容易被忽略的一点：你改了 KeyFunc 或加了 WithValidTimeFunc，但忘了在 echojwt.Config 里传进去——echojwt.WithConfig(jwtConfig) 中的 jwtConfig 必须包含这些函数，否则全白搭。
