spring-boot-migration

此迁移技能专为负责将旧版 Spring Boot 2.x 应用程序升级至 3.x 版本的软件工程师与后端开发人员而设计。这次升级至关重要，因为它涉及从 Java EE 转向 Jakarta EE 命名空间，这是一个重大的架构调整，常导致编译错误与依赖冲突。本技能提供了一份详尽的路线图，确保升级过程安全，并使项目在较新的 Java 版本与 Spring 框架下保持稳定与高效。

• 自动将父级 POM 版本从 2.7.x 升级至 3.2.x。

• 指导 Java 版本迁移至 OpenJDK 17 或 21，以符合 Spring Boot 3 的需求。

• 识别并移除已弃用的 JAXB API、JAXB 实现以及与 Jakarta EE 冲突的 Java Activation 依赖项。

• 提供将旧版 JWT 程式库（如 jjwt 0.9.1）替换为现代模块化版本的指南。

• 针对 Hibernate 6 与 H2 数据库方言调整的配置说明。

• 整合 OpenRewrite 以进行自动化代码重构与大规模配方执行。

• 使用 grep 指令进行验证，确保代码库中不再残留旧版 javax.* 的引用。

• 最适合管理目前受限于旧版 Java 8/11 与 Spring Boot 2 运行时环境的微服务或单体应用程序之开发者。

• 主要输入为基于 Maven 的项目结构。

• 使用者需留意迁移期间关于 Actuator 端点安全性与类路径（classpath）冲突的潜在运行时问题。

• 更新依赖项后，请务必执行完整的清理构建（Clean Build），以解决 Spring 生态系统中常见的传递依赖问题。

• 可使用提供的 sed 指令进行批量版本替换，但请务必手动验证变更，以防误损项目元数据。