用途:Sa-Token 是轻量级 Java 权限认证框架,核心包零依赖,面向 SpringBoot 等项目提供登录认证与权限校验。官方文档 https://sa-token.cc,GitHub https://github.com/dromara/sa-token,版本 v1.45.0。
主要能力:以 StpUtil 为核心门面,支持登录、注销、踢人下线、顶下线;Token 值/名称/信息查询、按 token 反查账号、有效期双策略(timeout 与 active-timeout);通过实现 StpInterface 定义权限与角色加载器,支持 checkPermission、checkRole 及权限通配符;注解鉴权 @SaCheckLogin、@SaCheckPermission、@SaCheckRole、@SaIgnore、@SaCheckOr;SaInterceptor 加 SaRouter 路由拦截;Account-Session、Token-Session、Custom-Session 三种会话模型;6 种内置 Token 风格、自定义生成策略与提交前缀;前后端分离与同端互斥登录。
必要用法:引入 sa-token-spring-boot-starter 依赖,在 application.yml 配置 token 名称与有效期等,实现 StpInterface,调用 StpUtil.login(id),再用 StpUtil 方法或注解校验,最后用 SaInterceptor + SaRouter 做全局路由鉴权。核心 API 示例:StpUtil.login(10001); StpUtil.checkLogin(); StpUtil.hasPermission("user.add"); StpUtil.kickout(10001); StpUtil.getSession();
限制:StpInterface 启动时不执行,仅在鉴权方法调用时触发;注解鉴权默认关闭,需手动注册 SaInterceptor;SaSession 与 HttpSession 无关;前端鉴权不能替代后端校验;@SaIgnore 只对 SaInterceptor 与 AOP 生效;@SaCheckPermission 默认 AND 模式,OR 需指定 mode = SaMode.OR;Cookie 模式默认注入 Cookie,可用 is-read-cookie: false 关闭。二级认证、SSO、OAuth2.0、微服务鉴权、API 签名、JWT/Redis 集成等不在本技能范围内。本技能不收集、存储或传输任何用户数据。