权限与安全

JWT 认证链路:从登录到请求鉴权

Spring Security + JWT 在 eladmin 里如何协作,Token 怎么签发、携带与校验,退出登录如何失效。

约 2 分钟533 字

eladmin 采用 JWT 做无状态认证。理解这条链路,排查「登录失效」「接口 401」类问题会快很多。

登录签发

用户提交账号密码 → Spring Security 的认证管理器校验 → 校验成功后生成 JWT(含用户标识与过期时间)→ 后端把 Token 与过期时间返回前端。密码通常用 BCrypt 加密存储,框架在用户新增时默认设置初始密码。

请求携带与校验

前端把 Token 放在请求头(默认 Authorization: Bearer xxx)。后端自定义过滤器拦截请求,解析并校验 Token 的合法性与有效期,通过后把用户信息注入安全上下文,后续 @PreAuthorize 注解据此鉴权。

Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...

退出与失效

JWT 本身无状态,退出登录通常由前端清除本地 Token,或后端配合 Redis 记录黑名单。若要求「改密码后旧 Token 立即失效」,需要引入版本号或黑名单机制。

安全加固建议

  • 生产环境务必用 HTTPS,防止 Token 被截获。
  • 设置合理过期时间,配合刷新 Token 机制。
  • 密钥不要写死在代码里,用环境变量或配置中心管理。