Eclipse 2023-12配置Wildfly目标环境时遇仓库读取失败问题

问题背景 #

在Eclipse 2023-12（Java EE版）中配置Wildfly目标运行时，通过【项目/属性/目标运行时/新建】选择‘Red Hat JBoss Middleware’下的‘JBoss AS, Wildfly, & EAP Server Tools’时，触发报错：

Unable to read repository at https://download.jboss.org/jbosstools/updates/webtools/photon/content.xml.

经测试，该URL返回HTTP 404（忽略证书错误后），且公司环境使用拦截代理，本地环境如下：

• Windows 10.0.19045.3930
• Microsoft JDK 21.0.1.12-hotspot
• Wildfly 29.0.1.Final
• Eclipse捆绑JVM：C:\Program Files\eclipse-jee-2023-12-R-win32-x86_64\eclipse\plugins/org.eclipse.justj.openjdk.hotspot.jre.full.win32.x86_64_17.0.9.v20231028-0858

排查与解决步骤 #

1. 替换过时的仓库URL #

photon是Eclipse 2018-09的版本代号，当前使用的2023-12版本对应的JBoss Tools仓库已更新，需替换为适配版本的URL：

• 打开Eclipse【帮助】→【安装新软件】，点击【添加】
• 在弹窗中输入：
  • 名称：JBoss Tools 2023-12
  • URL：https://download.jboss.org/jbosstools/updates/marketplace-4.26.0.Final/
• 点击【确定】后，重新选择‘JBoss AS, Wildfly, & EAP Server Tools’进行安装

2. 处理代理与证书信任问题 #

配置Eclipse代理

• 进入【窗口】→【首选项】→【常规】→【网络连接】
• 代理模式选择【手动】，填写公司提供的HTTP/HTTPS代理地址和端口
• 点击【编辑】，添加内部免代理地址（如有）
• 切换到【SSL】标签，点击【导入】，将公司代理的根证书（.crt格式）导入Eclipse信任存储

导入证书到Eclipse捆绑JVM

如果curl或Eclipse仍报证书错误，需将代理证书导入Eclipse自带JVM的信任存储：

• 找到捆绑JVM的cacerts文件路径：

  C:\Program Files\eclipse-jee-2023-12-R-win32-x86_64\eclipse\plugins/org.eclipse.justj.openjdk.hotspot.jre.full.win32.x86_64_17.0.9.v20231028-0858\jre\lib\security\cacerts
  

• 用keytool命令导入证书（以管理员身份运行CMD）：

  keytool -import -alias proxy-cert -file "你的代理证书路径.crt" -keystore "上述cacerts文件路径"
  

• 默认cacerts密码为changeit，按提示完成导入

3. 离线安装服务器工具（备选方案） #

若上述方法仍无法解决，可采用离线安装：

1. 下载对应Eclipse 2023-12版本的JBoss Tools离线安装包
2. 打开Eclipse【帮助】→【安装新软件】→【添加】→【本地】，选择下载的离线压缩包
3. 勾选‘JBoss AS, Wildfly, & EAP Server Tools’完成安装，重启Eclipse后再配置目标运行时

内容的提问来源于stack exchange，提问作者queeg