应使用 echo-jwt/v4 而非手写解析逻辑,因其内置标准验证、密钥轮换、错误映射与上下文注入;BasicAuth 与 Bearer Token 协议不同,裸写中间件易忽略大小写、空格、时钟偏移、claims 注入等关键点。

直接用 echo-jwt/v4,别手写解析逻辑——它已内置标准验证流程、密钥轮换支持、错误映射和上下文注入;手写极易漏掉 aud/iss 校验、时钟偏移容忍、jti 黑名单衔接等关键点。
为什么不能用 BasicAuth 或裸写中间件校验 Token
BasicAuth 只处理 Authorization: Basic base64(user:pass),而 Bearer Token 是完全不同的协议;裸写中间件常见错误包括:
- 没校验
Authorization头格式,比如忽略大小写("bearer"vs"Bearer")或空格位置 - 没剥离
"Bearer "前缀,导致后续jwt.Parse解析失败 - 没设置
TimeFunc容忍服务器时钟偏差,Token 实际有效却被判“已过期” - 没把 claims 注入
c.Get("user"),后续 handler 被迫重复解析,破坏上下文一致性
echo-jwt/v4 初始化必须传 SigningKey 且类型为 []byte
运行时报 nil key panic 的主因是初始化时漏传或类型错误:
在发送至付费API前,通过三层压缩预处理提示词;利用本地Ollama模型智能压缩消息并生成历史摘要。
-
SigningKey必须是[]byte,传string会编译失败(Go 类型不兼容) - 若用 RSA 公钥,需改用
KeyFunc+SigningMethod,不能直接传[]byte -
ContextKey建议显式指定(如"user"),避免依赖默认值导致后续取值混乱 -
ErrorHandler应返回标准 HTTP 错误(如c.JSON(401, ...)),而非裸return err
自定义 claims 结构体并安全提取用户 ID
默认的 jwt.MapClaims 是 map[string]interface{},类型不安全,容易在取 user_id 时 panic:
- 定义结构体继承
jwt.StandardClaims,字段名与 JWT payload 字段严格对应(如UserID uint `json:"user_id"`) - 通过
NewClaimsFunc返回该结构体指针,确保echo-jwt内部调用ParseWithClaims时能正确反序列化 - 后续 handler 中用
c.Get("user").(*CustomClaims)类型断言,再安全访问.UserID - 务必在签发端同步设置
claims["user_id"] = 123,否则结构体字段为空
黑名单校验必须链在 echo-jwt 之后,且不能重复解析 token
echo-jwt/v4 默认无状态,不查 Redis/DB;登出即失效需额外中间件:
- 黑名单中间件必须放在
e.Use(echojwt.WithConfig(...))之后,否则c.Get("user")还未注入 - 从
c.Get("user")直接断言为*jwt.Token,取token.Claims.(CustomClaims).UserID或token.Header["jti"],不要重新jwt.Parse - Redis key 建议用
revoked:{jti},TTL 对齐 token 的exp,避免手动计算过期时间 - 鉴权失败立即
return echo.NewHTTPError(http.StatusUnauthorized, "token revoked"),不调用next(c)
最易被忽略的是:时钟漂移容忍和 jti 写入一致性——服务端时间快几秒会导致合法 token 被拒;签发时不设 jti,黑名单就彻底失效。这两点不处理,再完整的中间件链也形同虚设。

















