做后端接口开发,权限认证是绕不开的一关。无论你是写微服务、给App提供API,还是最近在搞SPA单页应用,只要涉及用户登录态,就一定听过JWT这三个字母。JWT全称是JSON Web Token,简单说就是一种“带着签名的JSON通行证”,服务端不用存Session,客户端每次请求把Token带上,服务端验一下签名就能确认身份。我这几年用JWT替多个项目做过统一的权限认证方案,从最初的踩坑到后面整理出一套可复用的模板,中间积累了不少实操经验。这篇内容不算教科书,更像是我把整个入门过程、代码细节和常见坑位一次性给你梳理清楚,适合刚接触权限认证的初中级开发者,也适合那些已经在用JWT但想弄明白“为什么这么写”的同行。
1. 先把JWT的设计逻辑讲透
很多教程上来就贴代码,结果读者连Token长什么样、为什么分三段都没搞明白。我觉得要上手JWT,第一步不该是写代码,而是理解它为什么会被设计成现在这个样子。
1.1 从Session认证说起,JWT解决了什么
在JWT流行之前,最常见的是Session认证。用户登录成功后,服务端生成一个Session ID,存到内存或Redis里,同时把Session ID通过Cookie返回给浏览器。下次请求时浏览器自动带上Cookie,服务端拿着Session ID去查对应的用户信息,查到了就放行。
这套机制在传统的“单服务器+模板渲染”时代非常好用,但一旦进入分布式部署、前后端分离、移动端接入这些场景,问题就来了。Session存在哪台服务器上,请求就必须打到哪台服务器上,不然查不到状态;要是做跨端,App里根本没有Cookie这个概念,你得手动维护Session ID。更麻烦的是每次请求服务端都要查一次存储,高并发下Redis的压力也不小。
JWT的思路完全不同:用户登录成功后,服务端把用户ID、过期时间、权限标识等信息打包,用密钥签名,生成一串字符串交给客户端。之后客户端每次请求把头一装、Token一放就行,服务端只需要验签,不需要查任何会话存储。用一句话总结:Session是“状态存在服务端”,JWT是“状态存在客户端”。 这种设计天然适合无状态API,也方便横向扩容。
1.2 JWT三段式的组成原理
JWT字符串是两段点号连接的Base64Url编码内容,实际长这样:
code复制eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
中间用点号拆成三段:
| 段位 | 名称 | 保存内容 | 说明 |
|---|---|---|---|
| 第一段 | Header | 签名算法(alg)、Token类型(typ) | 一般固定为 |
| 第二段 | Payload | 用户ID、过期时间、角色等自定义声明 | 明文Base64Url编码,千万别放密码 |
| 第三段 | Signature | 前两段内容+密钥的签名结果 | 用于防篡改,也是JWT安全的核心所在 |
第三段签名是怎么算的?拿HS256举例,就是把Base64Url(Header) + "." + Base64Url(Payload)拼接起来,用HMAC-SHA256算法和密钥一起做哈希运算。所以哪怕有人把Payload改成自己的用户ID,因为不知道密钥,重新算出来的签名对不上,服务端验签就会失败。
这里有个特别重要的认知:JWT的第二段是明文,任何拿到Token的人用Base64一解码,就能看到你存进去的所有字段。 所以敏感信息绝对不能放进Payload,我见过有人把用户手机号、身份证直接放进去,这等于把隐私装进透明信封里发给所有人。
2. 权限认证的完整链路设计
理解了JWT的结构,接下来要回答一个核心问题:一套完整的权限认证体系,JWT到底在哪些环节起作用?我习惯把它拆成三个环节:登录发令牌、请求验身份、按权限做授权。很多新手把这三个环节混在一起,代码写得绕来绕去,就是没把职责拆分清楚。
2.1 登录签发Token的流程细节
登录接口是JWT体系的入口。用户提交用户名密码后,流程是这样的:
- 校验用户名密码是否合法;
- 从数据库查出用户ID、角色、权限标识;
- 把这些信息组织成JWT的Payload;
- 设置过期时间(比如2小时);
- 用密钥签名生成Token;
- 把Token返回给前端。
我在这一步会额外做两件事。第一,把用户的角色和权限码写进Token的自定义声明里,这样后续做接口级权限控制时不用再查一次库。第二,生成Token的同时预留一个“Token渠道标识”(比如用户登录的设备类型),一旦检测到用户在其他端重复登录,可以有依据地做踢人下线。
还有一点容易被忽略:登录接口本身要加防暴力破解措施。JWT只是认证机制,不负责帮你挡暴力攻击,频繁的登录尝试还得靠验证码、IP限流、账号锁定这些手段兜底。
2.2 请求携带与校验机制
客户端拿到Token之后,后续每个需要认证的接口都要带上它。最常见的做法是放在HTTP头里:
http复制Authorization: Bearer <token>
服务端需要写一个拦截器或者过滤器,统一拦截所有需要认证的请求。它的核心逻辑是:
- 从请求头里取出Au
