Eclipse Oxygen.3a鼠标悬停方法时抛出SSLHandshakeException问题排查

我来帮你拆解这个问题——你遇到的SSL握手异常其实和你主动执行更新之类的操作无关，是Eclipse的Javadoc悬停功能在后台悄悄发起网络请求导致的。

问题本质 #

从错误栈跟踪里能清晰看到关键调用链：BinaryMethod.getAttachedJavadoc → JavaElement.getURLContents，这说明当你把鼠标悬停在方法上时，Eclipse会尝试加载该方法关联的远程Javadoc文档。如果这个远程Javadoc服务器的SSL证书不被你的Eclipse所用JVM的信任存储认可，就会抛出PKIX path building failed的异常——这是Java SSL验证的标准错误，意思是找不到可信的证书路径来验证目标服务器。

解决步骤 #

以下是几种可行的解决方式，你可以根据自己的需求选择：

• 检查并调整Javadoc关联配置
  右键你的项目 → Properties → Java Build Path → 选中当前使用的库（比如JRE System Library） → 点击Javadoc Location按钮。你会看到这里配置了一个远程URL（比如旧版Oracle JDK的Javadoc地址），这个地址的SSL证书大概率不在你的JVM信任列表里。

  • 如果你想继续用远程Javadoc：手动将该网站的SSL证书导入到Eclipse使用的JVM信任存储中：
    1. 用浏览器打开这个Javadoc URL，导出网站的SSL证书（保存为.crt格式）
    2. 找到Eclipse使用的JDK/JRE目录下的jre/lib/security/cacerts文件
    3. 执行keytool命令导入证书（默认cacerts密码是changeit）：

       keytool -import -alias my-javadoc-cert -file /path/to/your/certificate.crt -keystore /path/to/jre/lib/security/cacerts
       

  • 更省心的方案：下载对应库的本地Javadoc压缩包（比如JDK的官方docs包），然后在Javadoc Location里选择Javadoc in archive，指定本地压缩包的路径，这样就不会再发起远程网络请求了。

• 禁用远程Javadoc自动加载
  如果不需要远程Javadoc内容，可以直接关闭这个功能：
  打开Window → Preferences → Java → Editor → Hovers，取消勾选Javadoc选项里的远程内容加载；或者进入Preferences → Java → Installed JREs，选中你的JRE点击Edit，清空或删除关联的远程Javadoc URL。

总结 #

这个异常完全是后台加载远程Javadoc时的SSL信任问题，和你主动触发的网络操作无关，只要调整Javadoc的来源配置就能解决。

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