高级套件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 运行时一致。
这个主题怎么样?