高級套件IBM Bob Java Modernization 進階套件

疑難排解

查找使用 IBM Bob 執行 Java Modernization 工作流程時可能遇到的常見問題的解決方案。

未偵測到 SDKMan 或 WinGet

確保 SDKMan 在你的 shell 設定檔中已初始化,並且在安裝後重新啟動了終端機工作階段。

  1. 開啟你的 shell 設定檔(~/.bashrc~/.zshrc)。
  2. 驗證 SDKMan 初始化區塊是否在檔案末尾存在。
  3. 重新啟動終端機工作階段。

安裝 WinGet 後,重新啟動 VS Code 和所有開啟的終端機,以便 Bob 可以偵測到更新的 PATH。

注意:

如果自動安裝被企業策略封鎖,請手動預先安裝目標 JDK,並將 JAVA_HOME 設定為指向它。


相依性解析錯誤

執行乾淨建置以強制重新下載相依性。

mvn clean install -U
gradle clean build --refresh-dependencies

Git flow 整合問題

確認 Git 已安裝並在系統 PATH 上可存取:

git --version

如果找不到命令,請為你的作業系統安裝 Git,並在重新啟動 Bob 之前確保它在 PATH 上可用。


UI 現代化:缺少後端或前端輸出

在啟動 UI 現代化工作流程之前,確保專案根目錄中存在 back/front/ 目錄。這些目錄必須在啟動工作流程之前手動建立。


AMA 套件問題(Liberty 遷移)

注意:

AMA Migration Bundle 必須從 AMA 版本 4.6.0 或更高版本產生。

如果遇到 AMA 套件問題,請檢查以下內容:

  • ZIP 必須在頂層包含 server.xml、遷移配方和相依性分析 — 沒有額外的包裝資料夾。
  • 如果部署至 Liberty 失敗,請驗證:
    • server.xml 功能集與安裝的 Liberty 版本匹配。
    • liberty-maven-plugin 版本與你的 Liberty 執行時間一致。
這個主題如何?