工程开发
spring-boot-migration avatar

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
在 GitHub 查看