网关层每秒十万次请求,每次都去 Redis 查一遍 token?高并发场景下这是瓶颈。换成 JWT 校验签名就行,但 JWT 又踢不了人。Sa-Token 给了三种模式让你按需取舍,外加一套业界最全的 SSO 三模式。
前置阅读:18.1 讲过 JWT 与 SSO 概念。这篇看源码里三种模式与单点登录的实现。
团队 A 做普通管理后台,想享受 Redis 会话的踢人能力。团队 B 做开放 API,想要无状态、不发 Redis。团队 C 两样都想要一点。同一个框架要伺候三种人——这就是 JWT 三模式的由来。
Redis 会话像实名制门票:闸机联网查你的购票记录,随时能作废。JWT 像带防伪钢印的票:闸机离线验钢印即可,快得很,但票卖出去了就收不回来。三种模式就是「实名 + 钢印」按不同比例勾兑。
引入 sa-token-jwt 插件并指定模式:
<dependency>
<groupId>cn.dev33</groupId>
<artifactId>sa-token-jwt</artifactId>
<version>1.44.0</version>
</dependency>
// 注册 Mixin 模式:jwt 只做 token 载体,会话数据仍在 Redis
@Bean
public StpLogic getStpLogicJwt() {
return new StpLogicJwtForMixin();
}
sa-token:
jwt-secret-key: "{{JWT_SECRET}}" # 密钥务必走配置中心/环境变量
token-style: jwt
// Same-Token:网关签发,下游校验
String sameToken = SaSameTemplate().getToken(); // 网关侧
saSameTemplate.checkCurrentRequestToken(); // 服务侧校验请求头
JWT 三模式,全部是 StpLogic 的子类,靠模板方法覆盖不同步骤:
| 模式 | 类 | 原理 | 能否踢人 |
|---|---|---|---|
| Simple | StpLogicJwtForSimple | jwt 只换 token 外观,会话照常存 | 能 |
| Mixin | StpLogicJwtForMixin | jwt 里嵌 loginId,减少一次 Redis 查询 | 能 |
| Stateless | StpLogicJwtForStateless | 登录信息全在 jwt 里,不依赖存储 | 不能 |
StpLogicJwtForStateless(StpLogicJwtForStateless.java:39 附近)的校验就是纯签名验证:解析 jwt、验签、取 loginId,全程不碰 SaTokenDao。这是网关层无状态校验的最优解,代价是签出去的 token 在过期前永远有效。
Same-Token 微服务鉴权是另一个易被忽略的点。网关拦住了外部请求,但内网里服务如果裸暴露,谁都能直连调用。SaSameTemplate(SaSameTemplate.java:32)的方案:网关定时刷新一个Same-Token(同源令牌,证明"这个请求来自持有密钥的自己人"),每次转发时带上 SA-SAME-TOKEN 请求头;下游服务拦截器校验这个头。没有密钥的裸调请求一律拒绝。RPC 场景还有 sa-token-dubbo、sa-token-grpc 插件做登录态透传。
SSO 单点登录三种模式,按前端是否跨域、后端是否同 Redis 组合出三档:
| 模式 | 场景 | 机制 |
|---|---|---|
| 模式一 | 前端同域 + 后端同 Redis | 共享 Cookie,最简单 |
| 模式二 | 前端跨域 + 后端同 Redis | URL 重定向传 ticket |
| 模式三 | 前端跨域 + 后端跨 Redis | HTTP 调用校验 ticket |
模式二的核心动作:子系统把用户重定向到认证中心,认证中心登录后发一个一次性 ticket(临时通行凭证),子系统拿 ticket 换用户信息。因为后端共享 Redis,ticket 校验就是本地读一次缓存,快。
模式三处理认证中心与子系统 Redis 不互通的场景:子系统服务端直接 HTTP 调认证中心的校验接口,配合签名防伪造。工程细节上还做了参数防丢(登录后精准回跳原 URL)和ticket 防劫持(域名校验加签名),甚至提供 NoSdk 方式让非 Java 系统也能对接。
再展开讲模式二的完整时序,这是面试和落地都最常考的一段。用户访问子系统的受保护页面,子系统发现未登录,拼好回调地址把用户重定向到认证中心。认证中心检查自己的 Cookie:已登录就直接签发一个一次性 ticket 拼在回调地址上跳回去;未登录就展示登录页。
子系统收到带 ticket 的回调后,在服务端拿 ticket 去认证中心换取 loginId,再签发本系统自己的会话。整个过程中 ticket 只用一次、有效期极短,即使被截获也无法重放——这就是ticket 防劫持的第一层。
第二层防线是域名白名单:认证中心只对注册过的子系统回调地址签发 ticket,防止钓鱼站点拿着认证中心的票冒充业务系统。第三层是签名:模式三里子系统与认证中心跨 Redis 通信,每次校验请求都带密钥签名,防止校验接口被伪造调用。
模式一最容易被低估。它看似"只是共享 Cookie",实则要求所有系统部署在同一个顶级域名下,且后端连同一个 Redis。它的好处是零跳转:用户在 A 系统登录后访问 B 系统,Cookie 自动带上,B 系统查 Redis 发现已登录,直接放行。用户全程无感知,这是三种模式里体验最好的。
选型建议给团队评审用:同公司内部系统且域名统一,闭眼选模式一;多子公司、域名各异但基础设施共享,选模式二;认证中心对外独立部署、各子系统网络隔离,选模式三。三种模式在 sa-token-sso 模块里是同一套代码的不同配置组合,不是三套实现。
同族能力还有 sa-token-oauth2:授权码、隐式、密码、客户端凭证四种标准模式齐备,可以直接当 OAuth2 授权服务器用。
「JWT 和 Redis 会话怎么选?」——答:看要不要主动失效。要踢人封禁选 Redis 会话;纯高并发无状态网关选 JWT Stateless;Sa-Token 的 Mixin 模式两头兼顾,jwt 减查询、Redis 保踢人。
「内网服务怎么防止绕过网关裸调?」——答:Sa-Token 的 Same-Token 机制,网关签发同源令牌随请求头下发,下游服务统一拦截校验,无密钥方无法伪造。
「SSO 模式二和模式三差在哪?」——答:差在后端是否共享 Redis。共享则子系统本地校验 ticket(模式二),不共享则 HTTP 调认证中心校验加签名(模式三)。