必须手动提取Token并结构校验:query用c.QueryParam,header需拆解Bearer;点号数须为2;base64url预检;ParseWithClaims后必须显式校验Valid()和alg≠none;claims结构化存Context复用;ErrorHandler需解包具体JWT错误类型。

怎么在 Echo 中间件里安全提取并校验 Token 字符串
不能依赖 echo-jwt 自动从 query 或 header 读取后就直接校验——它只在匹配到 token 后才解析,失败时静默跳过,你根本不知道是没传、传错位置,还是格式非法。必须手动提取 + 立即做轻量级结构校验。
常见错误是用 c.Param("token")(路径参数)或 c.FormValue("token")(表单)去取 query 里的 JWT,结果永远为空。正确方式只有一种:c.QueryParam("token") 或 c.Request().Header.Get("Authorization")。
- 若走 query:先判断非空,再检查点号数量:
strings.Count(token, ".") == 2,避免把"abc"这类无效字符串送进 JWT 解析器导致 panic - 若走 header:必须拆解
"Bearer xxx",不能直接把整个 header 值当 token 用 - 提取后建议立即 base64url 预检:对第二段做
strings.ReplaceAll(raw, "-", "+"); strings.ReplaceAll(raw, "_", "/"),再尝试base64.RawURLEncoding.DecodeString,失败则提前返回 400
为什么不能直接把原始 token 塞进 jwt.ParseWithClaims
因为 jwt.ParseWithClaims 默认不校验时间字段,也不拦截 alg: none 攻击。你传一个 exp: 1 的 token,只要签名“看起来对”,它就放行。这不是 bug,是设计宽松。
必须显式启用验证逻辑,且顺序不能错:先解析,再调 token.Claims.(jwt.StandardClaims).Valid(),最后还要手动比对 token.Header["alg"] 是否为 "none"。
在发送至付费API前,通过三层压缩预处理提示词;利用本地Ollama模型智能压缩消息并生成历史摘要。
- KeyFunc 中遇到
alg: none必须直接返回 error,不能 fallback 到空密钥 - 不要只看
err == nil就认为合法,token.Valid才是最终判决书 - 若 payload 里缺
exp,别让它默认通过——在 KeyFunc 里补个合理过期时间,或直接拒绝
怎么把校验后的 Claims 安全注入 Context 并复用
每次 handler 都重新 parse token 是 CPU 浪费,也容易漏掉时间校验。但直接存 tokenString 到 c.Set("user", ...) 没用,后续还得再 parse 一遍。
正确做法是在中间件里完成完整解析 + 校验后,把结构化 claims 缓存到 context,并确保类型安全。
- 定义
type MyClaims struct { UserID string `json:"user_id"`; jwt.StandardClaims },嵌入StandardClaims是为了能调Valid() - 解析成功且
token.Valid == true后,执行c.Set("claims", claims) - 后续 handler 用
c.Get("claims").(*MyClaims)直接取,不加断言会 panic,加了断言能早暴露问题 - 避免在多个中间件里重复解析:开头加
if c.Get("claims") != nil { return next(c) }
为什么 ErrorHandler 里只打印 err.Error() 还不够
因为 echo-jwt 的 ErrorHandler 接收的是 echo.HTTPError,而底层真实错误(比如 *jwt.TokenExpiredError 或 signature is invalid)被包了一层。只打 err.Error() 可能只看到 "Unauthorized",完全看不出是过期、签名错,还是算法不支持。
- 必须用
errors.As(err, &jwtErr)尝试解包,再根据具体类型补充日志,比如jwtErr.(*jwt.TokenExpiredError)就说明是时间问题 - 前端调试需要区分场景:过期应提示“请重新登录”,签名错要告警,
alg: none则必须记审计日志 - 别在
ParseTokenFunc里直接return echo.NewHTTPError(401, "..."),这会绕过中间件统一错误流,导致 CORS、日志等中间件失效
真正难的不是解析 JWT,而是让每个环节都带上下文意识:提取时知道来源是否可信,校验时知道哪些字段必须存在,出错时知道该向谁报什么信息。这些细节不写死在中间件里,就一定会在某个凌晨三点的线上报警里重现。










