sa-token-doc/blog/release/sa-token-v1-45-0-fa-bu-zheng-shi-zhi-chi-spring-boot-4-xin-zeng-jackson3-snack4.html
2026-03-09版本更新
Sa-Token 是一款 开源 、 免费 的轻量级 Java 权限认证框架,主要解决: 登录认证 、 权限认证 、 单点登录 、 OAuth2.0 、 微服务网关鉴权 等一系列权限相关问题。🔐
目前最新版本 v1.45.0 已推送至 Maven 中央仓库 🎉,大家可以通过如下方式引入:
<!-- Sa-Token 权限认证 -->
<dependency>
<groupId>cn.dev33</groupId>
<artifactId>sa-token-spring-boot4-starter</artifactId>
<version>1.45.0</version>
</dependency>
该版本包含大量 ⛏️️️新增特性、⛏️底层重构、⛏️️️代码优化 等,下面容我列举几条比较重要的更新内容供大家参阅:
Spring Boot 4 正式版发布后,社区里「求适配」的呼声就没停过!fix: #869、#IDB02G、#IDGQYM 这次,它真的来了!🎉
本次更新新增了完整的 Spring Boot 4 集成支持:🌟
同时配套新增了示例项目:
sa-token-demo-springboot4:Spring Boot 4 + WebMVC 整合 demo。sa-token-demo-webflux-springboot4:Spring Boot 4 + WebFlux 示例。如果你正在或计划升级到 Spring Boot 4,可以直接引入对应 starter,体验与 Spring Boot 2/3 一致的丝滑集成。✨
Sa-Token 在多端登录控制场景下,现已支持通过 replacedLoginExitMode 配置项自定义重复登录时的行为方式:
本次更新新增了配置项 replacedLoginExitMode,你可通过它自由选择策略,无需变动业务代码,灵活应对不同安全需求。配置项含义说明如下:
replacedLoginExitMode = OLD_DEVICE:旧设备下线,新设备登录成功( 默认行为 ,顶人下线模式)。replacedLoginExitMode = NEW_DEVICE:新设备登录失败,旧设备维持在线( 拦截本次登录 )。只需在 Sa-Token 配置文件或启动参数中切换即可,非常便捷。🛡️
merge: pr 349
Sa-Token 的 JSON 与序列化生态一直在持续丰富,本次又迎来两位新成员:📚
引入方式示例:
<!-- Sa-Token 整合 Jackson 3 -->
<dependency>
<groupId>cn.dev33</groupId>
<artifactId>sa-token-jackson3</artifactId>
<version>1.45.0</version>
</dependency>
<!-- Sa-Token 整合 Snack4 -->
<dependency>
<groupId>cn.dev33</groupId>
<artifactId>sa-token-snack4</artifactId>
<version>1.45.0</version>
</dependency>
无论你偏好 Jackson、Fastjson、Snack3 还是 Snack4,Sa-Token 都能满足。🎛️
本次版本对依赖体系进行了一次重要重构:🔧
sa-token-dependencies 相关模块,优化依赖关系,使版本管理更清晰。这是一次「看不见的升级」,但对长期维护和后续扩展都有积极影响。📐
SSO 单点登录模块在本版本也有不少文档与示例上的增强:📖
sa-token-sso 模块正式定义了 STS 协议,方便大家理解与对接。本版本修复了多个社区反馈的问题:🙏
sa-token-oauth2 组件使用 sa-token-fastjson2 序列化导致的类型转换问题。merge: pr 355StpUtil.getLoginIdByTokenNotThinkFreeze 方法缺少 static 修饰符的问题。文档与社区方面也有不少更新:❤️
除了以上提到的几点以外,还有更多更新点无法逐一详细介绍,下面是 v1.45.0 版本的完整更新日志:
core:
插件:
starter:
sa-token-spring-boot4-starter 集成包,支持 Spring Boot 4 环境集成。 [重要]sa-token-reactor-spring-boot4-starter 集成包,支持 Reactor + Spring Boot 4 环境集成。 [重要]sa-token-demo-springboot4、sa-token-demo-webflux-springboot4 示例。重构:
sa-token-dependencies 相关模块,优化依赖关系。 [重要]Solon:
sa-token-solon-plugin 优化 Gateway 接口的处理,避免使用路由接口。merge: pr 348SSO:
sa-token-sso 模块定义 STS 协议。 [重要]OAuth2:
文档:
AI:
其它:
更新日志在线文档直达链接:https://sa-token.com/doc.html#/more/update-log
代码仓库地址:https://gitee.com/dromara/sa-token
框架功能结构图:
← Sa-Token v1.43.0 发布 🚀,新增 SSO 单设备注销、消息推送,多 Access-Token 并存能力