用途:本规范用于在 Spring Boot 项目中集成 Sa-Token 1.38+ 权限认证框架,覆盖登录认证、权限校验、角色管理、JWT Token 处理等场景。技术栈为 Sa-Token 1.38+、Spring Boot 4.0.1,Redis 作为可选的 Token 持久化方案。
主要能力:通过 Maven 依赖 sa-token-spring-boot3-starter 与可选的 sa-token-jwt 引入;在 application.yml 中配置 token-name、timeout、active-timeout、is-concurrent、is-share、token-style、is-log、is-read-cookie、is-read-header、token-prefix 等参数。实现 StpInterface 提供权限码与角色标识数据源;AuthService 封装登录、登出、获取当前用户;控制器使用 @SaCheckLogin、@SaCheckPermission、@SaCheckRole、@SaIgnore、SaMode 等注解进行校验;通过 @RestControllerAdvice 统一处理 NotLoginException、NotPermissionException、NotRoleException;SaTokenConfig 注册 SaInterceptor 并配置拦截与放行路由。
使用方式:按资料中的依赖坐标、配置项与代码模板接入,权限标识采用 {模块}:{实体}:{操作} 格式,如 sys:user:list。常用 API 包括 StpUtil.login、logout、isLogin、checkLogin、getLoginId、getLoginIdAsLong、getTokenInfo、hasPermission、checkPermission、hasRole、checkRole、kickout。
适用场景:Spring Boot 后端系统的认证与授权、接口权限控制、角色校验、Token 管理。
限制:资料未提供具体收费、价格、平台与效果信息;生产环境 Token 存储、权限缓存等建议以资料中的最佳实践为准,其余细节暂未提供。