Sa-Token v1.45.0 发布 [特殊字符]，正式支持 Spring Boot 4、新增 Jackson3/Snack4 插件适配

n 是一款开源、免费的轻量级 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>

该版本包含大量 ⛏️️️新增特性、⛏️底层重构、⛏️️️代码优化 等，下面容我列举几条比较重要的更新内容供大家参阅：

🚀 更新点1：万人血书的 Spring Boot 4 集成包，它来了！

Spring Boot 4 正式版发布后，社区里「求适配」的呼声就没停过！fix: #869、#IDB02G、#IDGQYM 这次，它真的来了！🎉

本次更新新增了完整的 Spring Boot 4 集成支持：🌟

• sa-token-spring-boot4-starter：WebMVC 环境下的 Spring Boot 4 集成包。
• sa-token-reactor-spring-boot4-starter：Reactor 响应式环境下的 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 一致的丝滑集成。✨

🎯 更新点2：重复登录处理策略升级，可灵活配置是 “顶人下线” 还是 “不允许登录”

Sa-Token 在多端登录控制场景下，现已支持通过replacedLoginExitMode配置项自定义重复登录时的行为方式：

• 当同一账号不允许多客户端同时登录时，以往 Sa-Token 的默认策略为“新登录顶掉旧会话”，即新登录后会将旧端踢下线。🔄
• 但部分业务对安全性有更高要求，例如用户 A 已在手机端登录，再用电脑登录时，希望直接拦截本次登录，不影响原有会话，即提示“该账号已在其他设备登录，无法顶替下线”，而不是让手机端被踢下线。📱💻

本次更新新增了配置项replacedLoginExitMode，你可通过它自由选择策略，无需变动业务代码，灵活应对不同安全需求。配置项含义说明如下：

• replacedLoginExitMode = OLD_DEVICE：旧设备下线，新设备登录成功（默认行为，顶人下线模式）。
• replacedLoginExitMode = NEW_DEVICE：新设备登录失败，旧设备维持在线（拦截本次登录）。

只需在 Sa-Token 配置文件或启动参数中切换即可，非常便捷。🛡️

merge: pr 349

📦 更新点3：新增 sa-token-jackson3、sa-token-snack4 插件，生态持续扩展

Sa-Token 的 JSON 与序列化生态一直在持续丰富，本次又迎来两位新成员：📚

• sa-token-jackson3：用于 Jackson 3 的 JSON 操作。Jackson 3 是 Jackson 的最新大版本，如果你已经在使用 Jackson 3，现在可以无缝对接 Sa-Token 了。
• sa-token-snack4：用于 Snack4 的 JSON 操作。merge: pr 356

引入方式示例：

<!-- 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 都能满足。🎛️

🏗️ 更新点4：重构 sa-token-dependencies 及 WebMVC/Reactor 集成包

本次版本对依赖体系进行了一次重要重构：🔧

• 重构sa-token-dependencies相关模块，优化依赖关系，使版本管理更清晰。
• 重构 Spring Boot WebMVC/Reactor 相关集成包，优化模块划分与依赖传递。
• 优化整体模块依赖关系，减少冗余、提升构建效率。

这是一次「看不见的升级」，但对长期维护和后续扩展都有积极影响。📐

📺 更新点5：SSO 模块新增 STS 协议定义、视频讲解与平台中心模式 demo

SSO 单点登录模块在本版本也有不少文档与示例上的增强：📖

• STS 协议定义：文档为sa-token-sso模块正式定义了 STS 协议，方便大家理解与对接。
• 平台中心模式 demo：sso-server 前后端分离模式下，新增平台中心模式 demo 示例。
• 消息处理器相关文档：补全了 SSO 模块内置消息处理器相关文档，修复了 msgType 参数说明与 API 说明。🔗
• 视频讲解：B 站 up 主「王清江唷」录制了 SSO 篇共 29 集视频，从零到一讲解单点登录，非常适合入门与进阶。

🐞 更新点6：修复 OAuth2 序列化类型转换、Dubbo 上下文清理等问题

本版本修复了多个社区反馈的问题：🙏

• OAuth2：修复sa-token-oauth2组件使用sa-token-fastjson2序列化导致的类型转换问题。merge: pr 355
• Dubbo：修复 Dubbo 上下文清理问题，避免 RPC 调用时上下文污染。merge: pr 889
• Core：修复StpUtil.getLoginIdByTokenNotThinkFreeze方法缺少static修饰符的问题。
• Core：优化路由匹配 pattern 缓存算法，消除魔法值。merge: pr 907

📚 更新点7：文档与社区建设

文档与社区方面也有不少更新：❤️

• 新增Sa-Token 内容合作者群，欢迎愿意参与文档、教程、视频等内容创作的小伙伴加入。
• 新增赞赏码展示、文档首页 stars 对比图、解决跨域专题文章。
• 优化框架 Slogan、README、案例库展示。
• 文档主题切换增加水滴特效，登录认证、权限认证、路由拦截鉴权等章节优化。
• 补全全局策略说明、数据结构说明，目录树增加项目架构设计栏目。
• 新增 Maven 父子项目无法下载依赖的问题解决方案。merge: pr 358
• 新增《Gitee 2025 年度开源项目 Web 应用开发 Top 2》证书展示，感谢社区认可。🏆

📜 完整更新日志

除了以上提到的几点以外，还有更多更新点无法逐一详细介绍，下面是 v1.45.0 版本的完整更新日志：

• core：
  • 新增：新增重复登录处理策略，当同一账号不允许多客户端同时登录时支持选择踢人下线或拦截本次登录。[重要]merge: pr 349
  • 修复：修复StpUtil.getLoginIdByTokenNotThinkFreeze方法缺少static修饰符的问题。
  • 优化：优化路由匹配 pattern 缓存算法，消除魔法值。merge: pr 907
  • 优化：移除冗余导包。
• 插件：
  • 新增：新增sa-token-jackson3插件，用于 Jackson 3 的 JSON 操作。[重要]
  • 新增：新增sa-token-jackson3-test单元测试。
  • 新增：新增sa-token-snack4插件。[重要]merge: pr 356
  • 修复：修复 Dubbo 上下文清理问题。 merge: pr 889
  • 新增：loveqq-framework 版本更新。merge: pr 351
• 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示例。
  • 新增：新增 Spring Boot 4 整合 demo 示例。
• 重构：
  • 重构：重构sa-token-dependencies相关模块，优化依赖关系。[重要]
  • 重构：重构 Spring Boot WebMVC/Reactor 相关集成包，优化依赖关系。[重要]
  • 优化：优化整体模块依赖关系。
• Solon：
  • 优化：sa-token-solon-plugin优化 Gateway 接口的处理，避免使用路由接口。merge: pr 348
• SSO：
  • 新增：sso-server 前后端分离模式下 平台中心模式 demo 示例。
  • 修复：SSO 模块 msgType 参数说明、API 说明修正。
  • 新增：SSO 模块视频讲解链接：B站 王清江唷 SSO篇（29集）。[重要]
  • 补全：SSO 模块内置消息处理器相关文档。
  • 新增：文档为sa-token-sso模块定义 STS 协议。[重要]
• OAuth2：
  • 修复：修复sa-token-oauth2组件使用sa-token-fastjson2序列化导致的类型转换问题。merge: pr 355
  • 优化：修改ClientIdSecretModel的读取构建逻辑。merge: pr 346
• 文档：
  • 同步：同步公众号文章列表、博客列表、赞助者名单、企业登记案例。
  • 新增：新增 Sa-Token 内容合作者群。[重要]
  • 新增：新增《Gitee 2025 年度开源项目 Web 应用开发 Top 2》证书展示。
  • 新增：新增赞赏码展示、文档首页 stars 对比图。
  • 新增：新增解决跨域专题文章。
  • 新增：增加微信群聊信息展示。
  • 优化：优化框架 Slogan。
  • 优化：优化 README、案例库展示。
  • 优化：文档主题切换增加水滴特效，调整主题色块顺序。
  • 优化：文档优化 [登录认证]、[权限认证]、[路由拦截鉴权] 篇。
  • 优化：补全全局策略说明、数据结构说明。
  • 新增：目录树增加专门栏目记录项目架构设计。
  • 优化：功能结构图增加点击事件跳转到对应功能文档。