echo-jwt/v4仅验证exp和nbf字段,不生成或设置它们;签发时需用秒级int64时间戳正确写入payload,且须在KeyFunc中校验alg≠none、容忍时钟偏移±5s。

echo-jwt/v4 的 exp 和 nbf 字段必须由签发端控制
服务端用 echo-jwt 只做验证,不生成 token。生效时间(nbf)和过期时间(exp)必须在签发 JWT 时就写进 payload,中间件本身不提供设置接口。
常见错误是以为在 echo-jwt.Config 里能配过期逻辑——它只管解析和校验,不参与生成。如果你看到 token “刚签发就报 expired”,大概率是签发时 exp 值写错了(比如用了毫秒而非秒级 Unix 时间戳)。
- 签发时确保
exp是int64类型的秒级时间戳,例如time.Now().Add(15 * time.Minute).Unix() -
nbf同理,若需“10 秒后才生效”,就设为time.Now().Add(10 * time.Second).Unix() - 不要在验证中间件里手动修改
token.Claims—— 它是只读映射,改了也不生效
Keyfunc 中必须显式拒绝 alg: none 并校验时间偏移
echo-jwt 底层调用 jwt.ParseWithClaims,默认行为宽松得危险:不拒 alg: none、不强制验时间、不处理时钟漂移。这些都得在 Config.KeyFunc 或 Config.Validator 里补全。
否则攻击者可构造无签名 token 绕过校验,或利用服务端时间快于客户端几秒导致合法 token 被误判过期。
- 在
KeyFunc中检查token.Header["alg"] != "none",否则返回 error - 用
jwt.WithValidTimeFunc包装校验逻辑,容忍 ±5s 时钟偏差:func(t time.Time) bool { return t.After(time.Now().Add(-5 * time.Second)) && t.Before(time.Now().Add(5 * time.Second)) } - 别依赖
token.Valid默认行为——它只校验签名和字段存在性,不保证时间有效性
登出后 token 仍“有效”?黑名单得自己加,且必须原子写入
echo-jwt/v4 默认无状态,查不到黑名单是设计使然。要支持登出即失效,必须在它之后挂一个自定义中间件,从 c.Get("user") 拿已解析的 *jwt.Token,提取 jti 去 Redis 查。
Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
容易踩的坑是:Redis 写入非原子,高并发下用户登出后立刻重放旧 token,可能因写入延迟漏检。
- 签发时务必设置
jti:例如claims["jti"] = uuid.NewString() - 登出时用
SET revoked:{jti} "" EX 900 NX(EX 是 token 剩余 TTL,NX 保证仅当 key 不存在时才写入) - 校验中间件里直接
redisClient.Get(ctx, "revoked:" + jti),命中就return echo.NewHTTPError(http.StatusUnauthorized, "token revoked") - 别在中间件里重复
Parse——echo-jwt已完成解析,c.Get("user")就是现成的*jwt.Token
调试时怎么看 exp/nbf 到底设对没?用 docker-http-https-echo 快速解码
光看代码难判断时间字段是否生效,最直接的方式是把生成的 JWT 字符串丢进调试工具解码,看 payload 里 exp 和 nbf 的数值对应什么时间点。
推荐用 mendhak/http-https-echo 镜像,启动时指定 JWT_HEADER=Authorization,它会自动解码请求头里的 Bearer token 并输出格式化 JSON,时间戳还转成本地可读格式。
- 启动命令:
docker run -e JWT_HEADER=Authorization -p 8080:8080 --rm -d mendhak/http-https-echo:41 - 发请求:
curl -H "Authorization: Bearer eyJhbG...XadQssw5c" http://localhost:8080/ - 响应体里直接看到
"exp": 1733774400→ 对应2026-12-09 12:00:00,一目了然
真正麻烦的从来不是设参数,而是签发端和验证端对时间单位、时区、漂移的隐含假设不一致。每次改过期逻辑,都该拿真实 token 过一遍解码验证。










