关于 sa-token-integration
sa-token-integration 是 Sa-Token 集成扩展技能，面向需要配置认证组件的开发者。内容涵盖 JWT、Redis、AOP、模板引擎及 RPC 集成，并提供配置流程与适用边界。
主要功能
- 01JWT 三种集成模式
- 02Redis 持久化与缓存隔离
- 03Service 层注解鉴权
- 04快速登录页集成
- 05模板引擎鉴权标签
- 06RPC 上下文传播
适用场景
- 01为认证配置无状态 JWT
- 02在多实例间共享 Session
- 03在 Service 层执行注解鉴权
- 04在模板页面控制内容显隐
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/sa-token-integration确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
evaluation-report.htmlagents/openai.yamlexamples/integration-demo.mdreferences/dao-extend.mdjwt-extend.md详细介绍
来自项目 READMESa-Token 集成扩展
基于 sa-token-doc/plugin/ 集成类文档。
适用场景
当用户需要以下场景时，激活此技能：
- JWT无状态认证 — 将登录信息编码到Token中，减少Redis查询，适合高并发场景
- 分布式Session共享 — 多实例部署时需要共享会话数据
- Redis缓存隔离 — 将Sa-Token的Redis与业务Redis物理分开
- Service层注解鉴权 — 在Service层（非Controller）使用@SaCheckLogin等注解
- 快速搭建登录页面 — 开发环境或内管系统零代码登录页
- 模板引擎鉴权标签 — Thymeleaf/Freemarker页面中控制按钮显隐
Workflow
Step 1. 确定集成需求 — 选择JWT/Redis/AOP/模板等模块 Step 2. 引入依赖 — 添加对应Maven/Gradle依赖 Step 3. 配置参数 — 配置jwt-secret-key/Redis连接/Alone-Redis等 Step 4. 注入实现 — 注入StpLogic、注册过滤器、配置模板引擎 Step 5. 验证测试 — 确认集成生效，测试核心功能是否正常
Capability Boundaries
✅ Strong Suits
- JWT集成 — Simple/Mixin/Stateless三种模式选择
- Redis持久化 — JDK序列化/JSON序列化两种方式
- Alone-Redis独立Redis — 认证缓存与业务缓存物理隔离
- AOP注解鉴权 — 在Service层使用@SaCheckLogin等注解
- SpEL表达式 — @SaCheckEL使用Spring表达式
- Quick-Login快速登录 — 零代码注入登录页面
- JSON序列化扩展 — Jackson/Fastjson/Fastjson2/Snack3/Snack4
- 模板引擎集成 — Thymeleaf/Freemarker自定义标签
- RPC集成 — Dubbo/Dubbo3/gRPC上下文传播
⚠️ Requirements
- JWT需要配置
jwt-secret-key - Redis需要配置
spring.redis连接信息 - AOP注解与拦截器注解不能同时使用
❌ Out of Scope
- 基础登录/权限/注解鉴权 → sa-token
- SSO → sa-token-sso
- OAuth2.0 → sa-token-oauth2
- 微服务鉴权 → sa-token-micro
参考文档
| 主题 | 文件 | 来源 |
|---|---|---|
| JWT三模式(Simple/Mixin/Stateless) | references/jwt-extend.md | GitHub |
| Redis持久化+Alone-Redis | references/dao-extend.md | dao-extend、integ-redis |
FAQ
Q: JWT三种模式怎么选？ A: Simple模式推荐（功能完整：踢人、封禁、会话管理都支持）。需要无状态选Stateless（但踢人/封禁不可用）。Mixin介于两者之间。
Q: Redis两种序列化方式选哪个？ A: 推荐RedisTemplate JSON序列化（数据可读，方便排查）。JDK序列化兼容性更好但数据是乱码。
Q: Alone-Redis和普通Redis有什么区别？ A: Alone-Redis使用独立的Redis连接和数据库，与业务Redis完全隔离，保证认证缓存不受业务影响。
Q: AOP注解鉴权和拦截器鉴权能同时用吗？ A: 不能同时使用。AOP用于Service层，拦截器用于Controller层，选择一种即可。
Q: Quick-Login适合生产环境吗？ A: 适合小系统或内部管理系统。生产环境建议自定义登录页面。
Q: 模板引擎标签支持哪些功能？
A: 支持 sa:login（登录校验）、sa:hasRole（角色判断）、sa:hasPermission（权限判断）等标签。
Gotchas
- Simple模式
is-share恒等于false — 与Extra数据不兼容，无法共用token - Mixin模式
is-concurrent必须为true — 否则踢人下线API不可用 - JWT集成后Token变为JWT格式 — 不再是uuid格式，内容可解码查看
- Alone-Redis有独立的配置前缀
sa-token-alone-redis— 不是spring.redis - Redis JSON序列化后Session数据在Redis中可读 — 可在Redis客户端中直接查看
- AOP注解和拦截器注解不能混用 — 选了AOP就不能再用拦截器
- Quick-Login默认账号密码 sa/123456 — 生产环境务必修改
- Dubbo集成自动处理上下文传播 — 无需额外代码，引入依赖即可
Data Privacy
本技能不收集、存储或传输任何用户数据。所有代码示例仅供本地开发参考。