spring-boot-migration

此技能為將 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.*）時，仍需進行人工干預。

• 此技能透過驗證類別路徑並確保傳遞依賴不包含衝突的命名空間版本，協助解決常見的建置錯誤。

• 建議搭配版本控制系統使用，以確保在底層框架轉變導致執行時期行為變更時，可還原遷移變更。