前后端分离做了这么多年,权限认证这块几乎是每次都要面对的老问题。Session方案在前后端同域时代挺好用,可一旦前端拆出去单独部署,跨域、分布式、移动端适配这几个坎全都绕不过去。后来切到JWT(JSON Web Token)之后,这些问题算是从根上解决了一大半。这次把我从项目里沉淀下来的JWT权限认证实践整套整理出来,从原理、代码到续签、安全防护都过一遍,适合刚开始接触微服务或者前后端分离项目、打算把权限模块彻底搞清楚的开发者参考。
1. JWT认证的核心机制与设计思路
1.1 一段代码理清JWT三段式结构:Header.Payload.Signature
JWT本质上是一个经过签名的JSON字符串,由三个部分用点号拼接而成:头部(Header)、载荷(Payload)、签名(Signature)。我见过很多同事一开始被这东西吓住,觉得它高深,其实拆开看非常简单。
先看Header,它就是一个JSON对象,记录了令牌的类型和签名算法。最常见的是HS256,也就是HMAC-SHA256对称签名算法:
json复制{
"alg": "HS256",
"typ": "JWT"
}
再看Payload,这是整个令牌的核心业务区。里面放的是声明(Claims),比如用户ID、用户名、过期时间、签发时间等。下面这个是我在项目里常用的一组声明:
json复制{
"sub": "10086",
"username": "zhangsan",
"iat": 1710000000,
"exp": 1710003600
}
这里有个特别容易被误解的地方:Header和Payload只是被Base64URL编码,并没有加密。任何人拿到token,把它贴到jwt.io或者其他在线解析工具里,都能直接看到里面所有内容。所以千万别往Payload里塞密码、手机号、身份证这类敏感数据,不然等于把用户信息公开贴出去了。签名部分才是JWT安全性的真正来源,签名算法会结合Header里声明的算法、Base64URL编码后的Header与Payload,以及服务端持有的密钥,计算出一段签名摘要。
以HS256为例,签名的大致计算方式可以理解为:
text复制signature = HMACSHA256(
base64UrlEncode(header) + "." + base64UrlEncode(payload),
secretKey
)
Token的完整形态看起来就是下面这样,点号分隔三段:
text复制eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMDA4NiIsInVzZXJuYW1lIjoiemhhbmdzYW4ifQ.6fBxVn7sQy2bH0YLI1m_N3YQhgVW5N7zIoG_7h_V6G8
1.2 从登录到校验:一条Token的完整生命周期
理解了结构之后,再看JWT在真实项目里怎么流转。整个过程可以分成签发和校验两段,我用一个最典型的用户登录场景来讲。
第一步,用户提交用户名和密码。服务端校验账号密码成功后,组装好用户相关的Claims,结合密钥签发JWT,返回给前端。前端拿到token后,通常保存在localStorage或者内存中,后续所有需要认证的请求,都会在HTTP请求头里带上这样一个字段:
http复制Authorization: Bearer <token>
第二步,服务端收到请求后,拦截器或者过滤器先取出请求头里的token,依次做三件事:解析Header和Payload、用服务端密钥重新计算签名并对比、检查exp过期时间。只要签名不一致或者token过期,直接拒绝请求返回401。校验通过,才把请求放行到真正的业务接口。
这个过程中JWT最大的特点是服务端无需保存任何会话状态。token里该有的信息全都有,服务端只管验签,验完就信。这也是"无状态认证"这个词的来源。
1.3 为什么我在新项目里坚持用JWT而不是Session
不是所有项目都适合JWT,但如果你踩中了下面这几个场景,换成JWT会舒服很多。
第一个场景是前后端完全分离。前端部署在一个域名,后端接口在另一个域名,Session方案需要处理跨域Cookie、CSRF等一系列问题。JWT配合Authorization请求头,天然没有跨域携带的负担,只要前端在请求拦截器里统一加header就行。
第二个场景是横向扩展。Session是存储在服务端内存里的,一旦部署多台服务器,用户在第一台机器登录,第二台机器不认,就得引入Redis做会话共享。JWT无状态,每台服务器只靠密钥验签,谁接到请求都能直接处理,省掉了Redis存储这一层间接依赖。
第三个场景是移动端或第三方客户端接入。App、小程序、H5多端同时接入时,Session的Cookie机制在App里并不是那么顺手,而JWT只需要保存一个token字符串,放到哪个端都很自然。
当然,JWT也不是银弹。主动踢人下线做不了、token泄露后不好撤销,这些缺点在后文安全部分会详细说,但整体上对于大多数业务系统,JWT这套方案的收益是远大于代价的。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Spring Boot集成JWT:依赖、工具类、拦截器三步走
2.1 依赖引入与JWT工具类封装
技术选型上,Java生态里最常用的是jjwt这个库,github上star数非常高,API设计也比较顺手。这里以jjwt 0.11.5版本为例,首先在pom.xml里引入依赖:
xml复制<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt-api</artifactId>
<version>0.11.5</version>
</dependency>
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt-impl</artifactId>
<version>0.11.5</version>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>io.jsonwebtoken</
