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 指令進行批次版本替換，但請務必手動驗證變更，以防誤損專案詮釋資料。