c.Get("user")为空或panic根因是token无效(签名错、exp为毫秒、alg:none)导致中间件中断,未写入context;需检查中间件注册、TokenLookup配置、KeyFunc是否返回nil密钥、ContextKey是否被修改,并在ErrorHandler中通过*jwt.ValidationError位掩码捕获具体错误。

JWT Token 无效在 Echo 中通常不是“解析失败”,而是验证逻辑没走完、字段校验被跳过,或中间件根本没生效——直接看 c.Get("user") 是空或断言 panic 就能定位到根因。
为什么 c.Get("user") 取不到 token 或 panic
echo-jwt/v4 把解析后的 *jwt.Token 存进 context,默认 key 是 "user",但这个值只有在验证通过后才写入;如果 token 本身无效(比如签名错、exp 是毫秒时间戳、alg: none),中间件会中断链路,c.Get("user") 返回 nil,强制断言就会 panic。
- 检查中间件是否注册:确认用了
e.Use(echojwt.WithConfig(...)),而不是旧版middleware.JWT()(v5 已移除) - 确认
TokenLookup配置匹配前端传法:默认是"header:Authorization",若前端传的是query:token却没改配置,中间件压根不读 token - 别在 KeyFunc 里返回
nil密钥:返回nil, nil会导致jwt.ParseWithClaims直接 panic,必须返回密钥或明确 error -
ContextKey被改过?如果自定义了Config.ContextKey = "jwt_user",就得用c.Get("jwt_user"),不是"user"
token.Valid == true 却被业务逻辑拒绝
token.Valid 只表示签名正确、exp/nbf/iat 时间字段格式合法且未过期——它不校验 aud、iss、sub 等业务字段,也不拒绝 alg: none。很多“无效”其实是业务侧漏判。
- 显式校验
aud和iss:签发时设了aud: "api.example.com",验证时必须传jwt.ClaimsAudience{"api.example.com"}到WithAudience - 拦截
alg: none:在KeyFunc开头加判断:if token.Header["alg"] == "none" { return nil, errors.New("alg none not allowed") } - 补缺失字段:旧 token 没
exp?在KeyFunc里手动塞:claims["exp"] = time.Now().Add(24 * time.Hour).Unix() - 类型断言前先判空:
if claims, ok := token.Claims.(jwt.MapClaims); ok && claims != nil,避免直接claims["sub"].(string)panic
如何拿到具体的失败原因(比如过期 or 签名无效)
echo-jwt/v4 默认静默失败,不 panic,也不抛 error 给 defer/recover——你加 middleware.Recover() 完全捕获不到。唯一能稳定拿到错误细节的位置是 Config.ErrorHandler。
在发送至付费API前,通过三层压缩预处理提示词;利用本地Ollama模型智能压缩消息并生成历史摘要。
-
ErrorHandler会在验证失败时被调用,参数err是原始*jwt.ValidationError,可用位掩码判断:if e, ok := err.(*jwt.ValidationError); ok && e.Errors&jwt.ValidationErrorExpired != 0 - 不要在
ErrorHandler里手动c.JSON():echo-jwt 内部会处理响应,你只需return echo.NewHTTPError(...) - 避免耗时操作:ErrorHandler 同步执行,别在这里查 DB 或 Redis
- 统一日志:建议记录
err.Error()、请求路径、客户端 IP,方便排查是批量失效还是单点问题
WebSocket 接口鉴权失败却不报错
WebSocket 升级后 c.Request() 失效,所有鉴权必须在 upgrader.Upgrade() 前完成。挂中间件到 e.GET("/ws", handler) 是错的——中间件会先写响应头,导致 Upgrade() 失败。
- 正确做法:用原生
http.HandlerFunc提取token(从 query/header),手动调jwt.ParseWithClaims验证 - 验证失败直接
returnHTTP 错误(如 401),绝不继续 - 验证成功才调
upgrader.Upgrade(c.Response(), c.Request(), nil) - 别依赖
c.Get("user"):WebSocket 场景下 echo-jwt 中间件根本没机会运行,c.Get必然为空
真正容易被忽略的是时钟偏差和 Base64Url 编码兼容性:系统时间不准超 1 秒,exp 就会判定过期;旧 PHP/Python 库生成的 token 可能缺等号或换行,Go 的 base64.RawURLEncoding.DecodeString 会直接报 illegal base64 data——得先标准化 raw 字符串再解码。










