spring-boot-migration
将 Spring Boot 2.x 迁移至 3.x,包含自动化依赖管理、Java 17/21 升级以及 JAXB/Jakarta EE 重构。
简介
此技能为将 Java 应用程序从 Spring Boot 2.x 升级至 3.x 提供了完整的操作框架。由于从 Java EE 迁移至 Jakarta EE 命名空间,这一转变代表了重大的架构调整,经常导致依赖冲突与编译失败。此技能专为管理旧版 Java 项目的软件工程师、后端开发人员与 DevOps 专业人员设计,协助他们进行现代化改造,以符合当前的 Spring Framework 标准、提升性能并获得长期安全性支持。
-
自动化将 parent POM 版本从 2.7.x 迁移至 3.2.x 及以上版本。
-
将项目 Java 版本需求更新至 Java 17 或 21,确保与现代 LTS 版本兼容。
-
识别并移除不兼容的旧版依赖,特别是会与新的 Jakarta EE 实现产生冲突的 JAXB API、JAXB 实现以及 javax.activation。
-
提供替换弃用库(如旧版 jjwt)至现代模块化版本的清晰指令。
-
提供针对常见运行时期问题的指导,包含 H2 数据库方言配置变更及 Actuator 端点安全性路径更新。
-
整合 OpenRewrite 配方,促进原始码的自动化批量重构。
-
用户应提供 pom.xml 文件路径,以获取版本更新与清理的精确指令。
-
输出提供基于 sed 的字符串替换可执行 Shell 指令,以及依赖冲突解决的验证步骤。
-
实际限制包括当需要复杂类名称重构(从 javax.* 到 jakarta.*)时,仍需进行人工干预。
-
此技能通过验证类路径并确保传递依赖不包含冲突的命名空间版本,协助解决常见的构建错误。
-
建议搭配版本控制系统使用,以确保在底层框架转变导致运行时期行为变更时,可还原迁移变更。
仓库统计
- Star 数
- 1,078
- Fork 数
- 266
- Open Issue 数
- 38
- 主要语言
- PDDL
- 默认分支
- main
- 同步状态
- 空闲
- 最近同步时间
- 2026年4月29日 08:16