**这是本文档旧的修订版!**
JWT(JSON Web Token)
JWT 是鉴权中常用的一种令牌(token)格式标准,定义在 RFC 7519。一句话概括:把「你是谁、你有什么权限、什么时候过期」这些信息,由服务端签名后打包成一个字符串,交给客户端保存;之后每次请求带上它,服务端验签即可确认身份。
初学者容易误以为 JWT 是一种「鉴权框架」,其实它只是一套编码 + 签名的数据规范。真正的鉴权逻辑仍然由你的服务端代码决定。
长什么样
一个 JWT 由三个 Base64URL 片段用 . 连接而成:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwibmFtZSI6IkFsaWNlIn0.dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk
三段分别是:
| 部分 | 内容 | 是否可读 |
|---|---|---|
| Header | 算法与类型,如 {“alg”:“HS256”,“typ”:“JWT”} | 明文(仅 Base64 编码) |
| Payload | 载荷 / 声明(claims),如 sub、exp、角色 | 明文 |
| Signature | 对前两段的签名 | 无法伪造,但可见 |
关键点:JWT 默认只是编码,不是加密。 任何拿到令牌的人都能解出 Payload 的内容。所以里面不能放密码、身份证号、内部密钥之类的敏感信息。
鉴权流程
- 用户用账号密码登录,服务端校验通过
- 服务端签发一个 JWT(用密钥签名),返回给客户端
- 客户端保存(localStorage / Cookie / 内存),之后请求时放到请求头
- 服务端收到后只做验签 + 检查过期时间,从 Payload 直接读出身份,无需查询会话表
- 验签通过即认为该请求可信
典型请求头:
Authorization: Bearer <token>
和 Session 的区别
| 维度 | Session | JWT |
|---|---|---|
| 状态存放 | 服务端保存会话状态 | 状态写在令牌里(无状态) |
| 水平扩展 | 需要共享存储(Redis 等) | 天然支持多实例 |
| 能否立即失效 | 能,删掉会话即可 | 较难,签发后在到期前一直有效 |
| 体积 | 只传 sessionId | 每次都要携带完整载荷 |
| 适合场景 | 常规 Web 应用 | 多服务 / 微服务、跨域、移动端、SSO |
常见用途
- API 鉴权:前后端分离项目中最主流的方案(Bearer Token)
- 单点登录(SSO):一次登录,多系统互认
- 一次性票据:邮箱验证、密码重置链接
- 信息交换:在多方之间传递经过签名的可信声明
安全注意事项
- 必须显式校验签名算法,拒绝
alg为none的令牌,防止「算法混淆攻击」 - 设置合理的
exp过期时间,并配合 refresh token 续期 - Payload 不放敏感数据,它是可读的
- 撤销困难:若要「立即踢下线」,需额外维护黑名单或令牌版本号
- 存储位置:localStorage 易受 XSS 影响,HttpOnly Cookie 易受 CSRF 影响,按场景取舍
- 密钥要够强并妥善保管,密钥泄露等于任何人都能签发身份
小结
JWT 不是鉴权的全部,而是「一张由服务端签名、客户端随身携带、服务端只看不记」的通行证。它把状态从服务端搬进了令牌,换来扩展性,代价是撤销与过期管理更麻烦。
mdk height=460 color=#4f46e5
# JWT 鉴权
## 是什么
- RFC 7519 令牌格式标准
- 编码 + 签名,不是加密
- 鉴权逻辑仍由服务端决定
## 三段结构
- Header 算法与类型
- Payload 声明 claims
- Signature 签名
## 鉴权流程
- 登录校验通过
- 服务端签发令牌
- 客户端保存并携带
- 服务端验签 + 查过期
## 对比 Session
- 无状态 vs 服务端存储
- 易扩展 vs 易失效
- 载荷大 vs 只传 ID
## 典型用途
- API 鉴权 Bearer
- 单点登录 SSO
- 一次性票据
## 安全要点
- 拒绝 alg=none
- 设置 exp 与续期
- 不放敏感数据
- 撤销需黑名单
- 密钥妥善保管