真码实据REALCODE FACTS
源码评测 第 001 期 · 开源源码深度评测

Sa-Token 权限认证框架

轻量级 Java 权限认证框架 · v1.46.0 本地 Docker 从源码构建实测

项目描述(源自官方仓库与官网,2026-11-19 核对):开源、免费的一站式 Java 权限认证框架,让鉴权变得简单、优雅——一个 jar 包解决:

登录认证权限认证分布式 Session 会话微服务网关鉴权SSO 单点登录OAuth2.0 统一认证JWT 集成API 参数签名API Key 秘钥授权踢人下线二级认证临时 Token

国产认证框架人气王——登录鉴权一行代码搞定、踢人下线开箱即用,Gitee 近 5 万星、39 个官方插件覆盖 SSO/OAuth2/微服务全场景。

开源地址gitee.com/dromara/sa-token
Docker 镜像本地构建 1.09GB · 见 06 节
技术栈Java 8+ · Spring Boot 2.x/3.x 全适配
评测版本v1.46.0(2026-08-19 发布)
开源协议Apache-2.0 · 商用零限制
收费方式本体永久免费 · 衍生品 ¥5,999 起
Sa-Token 官方功能全景图(来源 sa-token.com 官网首页)
#F-01 · 官方功能全景图 · 来源 sa-token.com
8.7 9 维加权评分
14 项接口功能实测
3718QPS 峰值压测
11.8万行源码扫描
“

国产认证框架的头部标杆:Gitee ★49,570 + GitHub ★19,122 双平台人气第一梯队,评测当日仍在推送代码;14 项核心接口链路(登录/鉴权/权限/角色/通配/注解/踢人下线/并发登录)在本地 Docker 实测 14/14 全通,117,832 行源码仅 3 个超百行方法、644 个测试文件是同类项目罕见的工程纪律;代价是 doLogin 写 Redis 场景 P99 1.17s(Windows Docker VM 口径)、两个 2023 年严重 CVE 已修复但暴露过框架级风险面、demo 工程存在 SaTokenContext 兼容坑。综合 8.7 / 10:任何 Java 项目要加认证鉴权,它都是默认首选;需要开箱即用的完整产品化单点登录(而非框架)的团队请看官方付费衍生品 Sa-Pro。

项目档案 Project Dossier

出身与定位:Sa-Token 由 dromara 开源社区成员「ゞ瞎折腾、容唔下蓝颜」等人发起维护,2018 年开源至今 8 年,定位是「一站式 Java 权限认证框架」——登录认证、权限认证、单点登录、OAuth2.0、分布式会话、踢人下线、微服务网关鉴权等 30+ 能力一个 jar 包解决;以「简单到极致」为设计哲学,官方口号是把权限认证做成「一行代码」的事。Gitee ★49,570GitHub ★19,122在国产 Java 认证框架中人气断层第一。

功能版图与技术栈:39 个官方插件覆盖 Spring Boot 2.x/3.x、WebFlux、Solon、jFinal 等全技术栈适配,plus 插件提供 OAuth2 服务端、SSO、临时令牌、同端互踢、二级认证、防 ReDoS/防暴力破解等增值模块;核心仅依赖 JDK8+(无强制第三方依赖),Redis 会话存储为可选插件;官方文档站 145 篇专题文档全覆盖——本期评测在本地 Docker 容器中以官方 demo-case 综合演示工程真实运行,117,832 行源码全量静态扫描。

版本与商业形态:本体 Apache-2.0 协议永久免费(官方文档明确承诺终身免费),代码级无任何 license 校验、激活码、试用期或用户数限制;商业形态为独立衍生产品——公开价格(来源 sa-max.cn 销售页与 sa-token.cc 官方文档,2026-11-18 抓取):Sa-Pro 单点登录商业版 ¥5,999 起、Sa-Max 统一认证综合版 ¥9,999 起,均为一次购买永久授权、全源码交付、不限域名与项目数;隐性成本极低(框架本身只需应用自有服务器 + 可选 Redis),无 SaaS 套餐、无实施绑定。收费确定性在同类项目中属最高档。

三句话评语优点 · 短板 · 适合谁

值得夸

  • 工程纪律罕见:11.8 万行仅 3 个超百行方法(代码 · 8.8)
  • 踢人下线/并发登录实测即用(F4 · 9.0)
  • 644 个测试文件,测试密度同类罕见

要吐槽

  • doLogin 写 Redis P99 1.17s(Windows Docker VM 口径)
  • demo 工程存在 SaTokenContext 兼容坑(404 兜底报错)
  • 历史 2 个严重 CVE 提权/绕过(1.37.0 已修复)

谁该用

  • 任何需要登录鉴权的 Java 项目
  • 微服务/前后端分离架构的认证底座
  • 要开箱即用 SaaS 级 SSO 产品别来(看 Sa-Pro)
一键体验
镜像 ~1.09 GB 启动 ~45 s 账号 zhang / 123456 访问 localhost:8081
$docker network create stnet && docker run -d --name satoken-redis --network stnet redis:7-alpine && docker run -d --name satoken-app --network stnet -p 8081:8081 -e SPRING_REDIS_HOST=satoken-redis crpi-bfp61hn0anlbem5v.cn-hangzhou.personal.cr.aliyuncs.com/sourceradar/sa-token:1.46.0-r001
官方 demo-case 综合演示(登录/鉴权/踢人下线 20+ 接口)· 镜像 tar 分发与构建复现见下方 06 节
00

九维评分

Scorecard · 9 Dimensions
点击任意维度、雷达图标签或评分依据行,可查看该评分的打分依据与规则。
8.7 功能 8.5 文档 9.0 收费模式 9.3 性能 7.8 代码 8.8 安全 8.2 社区 9.2 维护 9.0 许可 9.5
高分 ≥ 8.9 平常 7.5–8.8 需注意 < 7.5
点击任意维度或雷达图标签,可查看该评分的依据与规则
功能8.514 项核心接口实测全通(登录/鉴权/踢人下线/并发登录);SSO/OAuth2/网关鉴权等宣称能力未逐一实测
文档9.0官方文档站 145 篇专题全覆盖、示例即贴即用;中文社区文档体系同类最佳
收费模式9.3Apache-2.0 本体零墙、终身免费承诺;商业衍生品明码标价 ¥5,999/¥9,999 永久授权
性能7.8匿名 3718 / 登录态读 2999 QPS、P90 101–123ms;doLogin 写 Redis P99 1.17s 拉低档位
代码8.8117,832 行仅 3 个超百行方法(最长 168 行);644 个测试文件、39 插件模块化
安全8.22 个严重历史 CVE 均在 1.36/1.37 修复、v1.46 已覆盖;框架安全性依赖集成方正确配置
社区9.2Gitee ★49,570 / GitHub ★19,122 / 贡献者 83,dromara 顶级组织;issue 时效未采样
维护9.0评测当日(2026-11-18)仍在推送;8 年持续迭代无断更,插件生态持续扩编
许可9.5Apache-2.0 宽松协议:商用/闭源集成/SaaS 化零限制,仅需保留版权声明
01

核心功能实测

Field Test · 6
功能逐项列表打分,评分可点击查看详情;实测截图集中展示于上方,点击可放大。
实测环境与方法:Windows 11 + Docker Desktop 29.1.3(WSL2)· 本地从源码构建镜像 crpi-bfp61hn0anlbem5v.cn-hangzhou.personal.cr.aliyuncs.com/sourceradar/sa-token:1.46.0-r001(Maven 3.9.9 从源码 install 核心模块 + 打包官方 demo-case,JRE 21 运行 + Redis 7 会话存储)· curl/cj cookie 会话逐接口实测 + Chrome 截图存证 · 演示账号 zhang/123456。每项功能按「接口调用 → 边界尝试(错密码/未登录/无权限/踢人后访问)→ 记录坑点」四步走查,共 14 项全部留痕。
功能评分功能说明实测结论
登录认证与会话管理 8.5 · 达标 doLogin 正确/错误密码双分支 → 会话写入 Redis → isLogin 登录态查询。正确密码 签发 satoken错误密码 正确拒绝 正确密码返回 satoken UUID 并确认写入 Redis(satoken:login:token:xxx 键存在),错误密码正确返回「账号或密码错误」JSON;会话 cookie 自动携带,isLogin 链路即查即答。扣分:演示工程为 GET 明文传参(生产应 POST+加密),属 demo 教学简化非框架缺陷。
鉴权拦截三防线 8.5 · 达标 未登录访问 checkLogin 被拦截 → 无权限调 checkPermission 被拒(缺 user.delete)→ 无角色调 checkRole 被拒(缺 ceo)。未登录拦截 通过权限/角色 精确拒绝 三道防线行为精确:未登录返回「未能读取到有效 token」,无权限返回「无此权限:user.delete」、无角色返回「无此角色:ceo」——错误信息可直接定位缺失项,排障体验好;通配权限 art.* 实测命中 art-add 等子路径。
注解鉴权 8.0 · 达标 @SaCheckLogin / @SaCheckPermission 注解在带 cookie 与匿名两种状态下分别实测。注解拦截 生效匿名访问 被拒 注解鉴权与编程式鉴权行为一致、响应一致,拦截器注册即生效无需额外配置;扣分:注解细节场景(@SaCheckOr、二级认证、模式匹配 AND/OR 组合)未逐一实测,按宣称能力与实测代表样本计分。
踢人下线与并发登录 9.0 · 达标 kickout?userId=10001 踢人 → 被踢会话 isLogin 立即变 false → 同账号二次登录验证顶人/互踢行为。踢人 即时生效会话失效 跨端一致 踢人下线实测「秒级生效」:踢出后旧 cookie 立即失活(isLogin 返回 false),Redis 会话键同步移除;并发登录控制开箱即用无需额外配置——这是本项拿到 9.0 的原因:完全实测、行为零妥协。
SaTokenContext 兼容性(边界) 7.0 · 有坑 访问不存在的路由触发 demo 404 兜底处理器,处理器内调 StpUtil 报「SaTokenContext 上下文尚未初始化」。404 兜底 报错正常路由 不受影响 坑点:v1.46 上下文模型变更后,非 Web 请求上下文(如 404 兜底/异步线程)中调用 StpUtil 会抛 SaTokenContext 异常——正常业务路由不受影响,但 demo 的 404 兜底处理器踩中此坑;集成方需注意在非请求线程中使用 SaTokenContext 模型或改用 SaHolder。属升级兼容性问题,框架本身有对应 API 支持。
02

性能数据

Benchmarks
3718 QPS
匿名鉴权查询 · 30 并发
155 ms
P90 延迟 · 全场景低于 160ms
1.17 s
P99 · doLogin 写 Redis 场景
吞吐量 QPS 越高越好 · autocannon 30 并发 × 12s × 3 组
匿名鉴权查询(纯框架开销)
3718
登录态查询(Redis 读)
2999
P90 响应时间 越低越好 · 单位 ms
doLogin 登录(Redis 写)
155
登录态查询(Redis 读)
123
💬 一句话:读场景(鉴权查询)P90 101–123ms、QPS 3000+ 毫无压力;唯一的尾巴是 doLogin 写 Redis 场景 P97.5 513ms / P99 1.17s——每笔登录要新建会话+写 Redis+事件发布,且本轮测在 Windows Docker Desktop VM 共享资源上,属保守口径;独占 Linux 环境 + Redis 调优后预计有数倍提升空间。三组压测全程零错误、全 2xx,框架层无异常泄漏。
03

安全核查结果

Security Check
编号等级来源风险说明处置方式状态
VUL-01严重CVE-2023-44794≤1.36.0 构造 URL 提权漏洞(CVSS 9.8)升级至 1.37.0+✅ v1.46.0 已修复
VUL-02高危CVE-2023-43961≤1.36.0 Spring 动态控制器鉴权绕过(CVSS 8.8)升级至 1.36.0+✅ v1.46.0 已修复
CFG-01中危演示账号demo 演示账号 zhang/123456 公开明文自部署后立即改密并移除 demo 工程登录接口⚠️ 需处置
CFG-02中危集成责任框架级安全依赖集成方正确配置拦截路径,漏配即裸奔上线前按官方「路由拦截统计」逐条核对⚠️ 需处置
NOTE-01关注实测发现404 兜底/非请求上下文调 StpUtil 抛 SaTokenContext 异常(demo 兼容坑)升级后按官方迁移文档适配上下文模型⚠️ 关注

核查口径:NVD/GitHub Advisory/OSCS 公开 CVE 库逐条核对(2026-11-18 抓取)+ 本地容器实测 + 默认配置检查(未运行商业化漏扫)。两个历史严重漏洞均在评测版本前修复;框架「安全但不兜底」的定位需集成方自查拦截配置。

04

源码质量抽检

Code Review
检查项结果评定
模块分层core(304 文件/4.2 万行)+ 28 个 starter + 39 个官方插件 + BOM 统一版本管理,按技术栈与功能双维度拆分优
超长方法全量 1,019 个 Java 文件花括号深度扫描:超 100 行方法仅 3 个(0.3%),最长 168 行优
代码规模117,832 行 Java / 1,019 文件,体量适中、单文件职责单一优
测试覆盖644 个测试文件(与主代码文件比 0.63:1),测试密度在同类国产框架中罕见优
依赖策略核心零强制第三方依赖(纯 JDK8+),Redis/Redisson 等为可选插件——集成方按需引入优

抽检口径:1,019 个主代码 Java 文件全量花括号深度扫描 + 目录规模统计(评分规则页 · 05 源码质量)。sa-token-doc 与 demo 工程未纳入主代码口径。

05

社区与维护数据

Community & Maintenance
指标数值解读
Gitee Star / Fork★ 49,570 / 4,572(GitHub 侧另有 ★19,122 / fork 2,914)国产框架人气第一梯队
最新版本v1.46.0(2026-08-19,新增 Apache Fory / Redisson 集成)持续发布
发布节奏8 年持续迭代,小版本高频发布 + 插件生态持续扩编节奏稳定
主仓状态评测当日(2026-11-18)仍在推送代码无断更风险
渠道生态官方文档站(145 篇)+ QQ 交流群 + issue 双平台 + 商业衍生品渠道齐全

采样口径:Gitee API v5 + GitHub API 仓库数据 + 本地克隆 git log(评分规则页 · 07 社区 / 08 维护)。issue 响应时效本期未采样,未计入加分。

06

Docker 进阶与复现环境

Deployment & Reproduce
# 从镜像 tar 加载(image/ 目录内 sa-token-1.46.0-r001.tar)
docker load -i sa-token-1.46.0-r001.tar
# 两条命令启动(Redis + 应用)
docker network create stnet
docker run -d --name satoken-redis --network stnet redis:7-alpine
docker run -d --name satoken-app --network stnet -p 8081:8081 \
  -e SPRING_REDIS_HOST=satoken-redis crpi-bfp61hn0anlbem5v.cn-hangzhou.personal.cr.aliyuncs.com/sourceradar/sa-token:1.46.0-r001
# 验证:登录成功即部署完成
curl "http://127.0.0.1:8081/acc/doLogin?name=zhang&pwd=123456"

启动耗时:应用容器就绪约 45 秒(JVM + Tomcat + Redis 连接),首次 load tar 约 30 秒。

重置环境:docker rm -f satoken-app satoken-redis && docker network rm stnet 后重跑即可,框架无持久化状态。

镜像可信吗:完全从官方仓库源码构建(Maven 3.9.9 install core/starter/redis-jackson/spring-el 四个模块 → 打包官方 demo-case → JRE 21 运行),未使用任何第三方预构建镜像;构建 Dockerfile 与 compose 随交付包开源。构建过程踩坑实录:①demo-case 官方 pom 未配 spring-boot-maven-plugin(按 IDE 运行设计),构建期需注入 repackage;②仓库 ${revision} 未扁平化 pom 从本地仓库解析报模型错误,需将 demo 挂入根 reactor 同体构建;③基础镜像源多家全挂,改用 Maven 官方二进制打入镜像。

复现环境:Windows 11 / Docker Desktop 29.1.3(WSL2)/ Maven 3.9.9 + JDK21 / autocannon 30 并发 × 12s × 3 组。

— 附卷 · 九维评分加权细目 —
九维评分加权细目 ›
维度权重得分加权评分依据
功能20%8.51.7014 项接口实测全通;SSO/OAuth2 等宣称能力未逐一实测
代码15%8.81.32超百行方法仅 3 个;644 个测试文件、39 插件模块化
文档10%9.00.90官方文档站 145 篇专题全覆盖,示例即贴即用
收费模式10%9.30.93Apache-2.0 本体零墙终身免费;衍生品明码标价
性能10%7.80.78读场景 2999 QPS / P90 123ms;doLogin 写 P99 1.17s(VM 口径)
安全10%8.20.822 个严重 CVE 均已修复;集成方需自查拦截配置
社区10%9.20.92Gitee ★49,570 / GitHub ★19,122;issue 时效未采样
维护10%9.00.90评测当日仍在推送;8 年无断更
许可5%9.50.475Apache-2.0:商用/闭源/SaaS 零限制

加权合计 8.745 → 8.7(四舍五入保留一位小数,即报告展示的总分)。

功能
权重 20% · 档位
9.0

评分依据 · 实测证据

评分规则 · 本档锚点

完整分档标准(0–10)