用途:本技能面向 Sa-Token 的插件与集成扩展,帮助在 Java 项目中接入 JWT 无状态认证、分布式 Session 共享、Redis 缓存隔离、Service 层注解鉴权等能力,适合高并发认证与多实例部署场景。
主要能力:JWT 集成提供 Simple、Mixin、Stateless 三种模式对比选择;Redis 持久化支持 JDK 与 JSON 两种序列化;Alone-Redis 把鉴权缓存与业务缓存物理隔离;AOP 注解鉴权可在 Service 层使用 @SaCheckLogin 等注解;支持 @SaCheckEL 的 SpEL 表达式;Quick-Login 零代码生成登录页;JSON 序列化扩展涵盖 Jackson、Fastjson、Fastjson2、Snack3、Snack4;模板引擎集成 Thymeleaf、Freemarker 自定义标签;RPC 集成涵盖 Dubbo、Dubbo3、gRPC 上下文传播。
使用方式:先确定集成模块,再引入对应 Maven/Gradle 依赖,配置 jwt-secret-key、spring.redis 连接或 sa-token-alone-redis 独立前缀,随后注入 StpLogic、注册过滤器或配置模板引擎,最后验证集成是否生效。
限制:JWT 需配置 jwt-secret-key;Redis 需配置 spring.redis;AOP 注解与拦截器注解不能同时使用。Simple 模式 is-share 恒为 false,与 Extra 数据不兼容;Mixin 模式 is-concurrent 必须为 true;单独使用 JWT 后 Token 变为 JWT 格式;Quick-Login 默认账号密码为 sa/123456,生产环境务必修改,且更适合小系统或内管系统。基础登录鉴权、SSO、OAuth2.0、微服务鉴权不在本技能范围内。本技能不收集、存储或传输任何用户数据。