PAYATHON 2026

Eclipse 2024-09 安装 Plugins 时卡在 fetching

排障赵师傅

结论

从日志看,问题已经缩小到 Eclipse 的 p2 安装器。安装任务停在 AuthorityChecker.gatherCertificates(),正在等待一个尚未完成的 CompletableFuture。这个阶段通常会检查下载后的 JAR 签名、证书链和发布者信息。因此,界面显示 fetching 时,实际卡住的位置未必是网络下载。

Trust all content 控制的是是否自动接受尚未信任的发布者。JAR 读取、签名解析和证书收集仍会照常执行,所以选中该选项后安装仍然挂起并不矛盾。

一份线程栈不足以判断具体原因。Eclipse 4.33 的 p2 缺陷、损坏的下载缓存、安全软件拦截、代理或 TLS 检查,以及更新站点返回异常内容,都有可能造成这种现象。可以按下面的顺序逐步排查。

为什么每次卡住的 fetching 项都不同

p2 会并行下载和处理多个插件及其依赖。进度窗口显示的是当时正在更新的任务,未必就是引起等待的任务。

如果后台的证书检查一直没有完成,其他下载任务仍可能继续执行。因此,每次重试时显示的最后一项可能不同。文件名随机变化,不能说明这些插件分别存在损坏。

线程栈中的关键调用是:

CompletableFuture.get
AuthorityChecker.gatherCertificates
AuthorityChecker.getCertificates
AuthorityChecker.start
Collect.completePhase

这些调用说明安装计划已经执行到 Collect 阶段末尾的 authority 检查。日志中的 Logback 提示和 EGit HOME 环境变量警告与本次安装挂起没有直接关系。

先缩小软件站点范围

打开:

Window
  -> Preferences
  -> Install/Update
  -> Available Software Sites

暂时禁用与本次安装无关的第三方站点,只保留:

  • 当前插件的更新站点;
  • 解析 Eclipse 平台依赖所需的 Eclipse 2024-09 release repository。

如果安装页面选中了:

Contact all update sites during install to find required software

先取消该选项,再测试一次,以免 p2 同时访问大量历史站点或失效镜像。

插件也应逐个安装。一次安装 Checkstyle、SpotBugs、SubEclipse 和 Web Developer Tools,会引入更多依赖解析和证书检查变量。

检查代理、HTTPS 和镜像连接

在 Eclipse 中检查:

Window
  -> Preferences
  -> General
  -> Network Connections

在家庭网络下,可以先测试:

Active Provider: Native

如果仍然挂起,再测试 Direct。公司或学校网络需要代理时,应填写实际的代理配置,不宜直接切换到 Direct。

也可以在 PowerShell 中直接请求更新站点:

Invoke-WebRequest "https://更新站点地址/" -UseBasicParsing

如果已经从 p2 日志中找到具体的 content.jar、artifacts.jar 或插件 JAR 地址,分别进行测试:

Invoke-WebRequest "https://更新站点地址/content.jar" -OutFile "$env:TEMP\content.jar"
Invoke-WebRequest "https://更新站点地址/artifacts.jar" -OutFile "$env:TEMP\artifacts.jar"

如果请求超时、连接被重置、出现证书错误,或者下载文件的大小反复变化,应先排查网络、代理、HTTPS inspection 和镜像。

不要通过关闭 TLS 验证来处理证书问题。如果学校或公司的代理会重新签发 HTTPS 证书,应由管理员提供根证书,再将其导入 Eclipse 实际使用的 JDK trust store。

排除安全软件对 JAR 文件的拦截

Windows Defender 或第三方安全软件可能在 JAR 下载完成后立即扫描、隔离或锁定文件。此时 p2 正在读取签名,可能会长时间等待。

可以进行一次受控测试:

  1. 退出 Eclipse。
  2. 确认没有残留的 javaw.exe 或 Eclipse 安装任务。
  3. 将 Eclipse 解压到普通的本地目录,例如 C:\Tools\eclipse。
  4. 使用一个新的空 workspace。
  5. 临时为 Eclipse 安装目录和 p2 缓存目录设置安全软件排除项。
  6. 只安装一个插件。

仅在确认插件来源可信时进行这项测试,测试结束后恢复安全软件配置。如果设置排除项后安装恢复正常,再结合安全软件日志,制定范围更小的目录或进程规则。

使用干净安装和新的 p2 缓存验证

反复强制关闭 Eclipse,可能会留下不完整的 p2 下载文件或安装状态。验证时最好重新解压一份 Eclipse,不要覆盖现有目录。

如果系统使用 Eclipse Installer,共享 bundle pool 仍可能复用旧缓存。可以在 Eclipse Installer 中新建独立安装,或者先备份,再处理对应的 bundle pool。不要直接删除整个 %USERPROFILE%\.p2,因为其他 Eclipse 安装可能也在使用其中的内容。

如果新安装可以正常工作,而旧安装仍然挂起,问题基本可以缩小到旧安装的 p2 状态或共享缓存。

更换 Java 21 补丁版本测试

Eclipse 2024-09 使用 Java 21 没有问题,日志中的 21.0.4 也不足以证明存在兼容性错误。不过,签名和证书处理依赖 JDK 的安全组件,可以换用较新的 Java 21 补丁版本进行测试。

在 eclipse.ini 中可以明确指定 JDK。-vm 必须放在 -vmargs 之前:

-vm
C:\Program Files\Eclipse Adoptium\jdk-21\bin\javaw.exe
-vmargs
-Xms256m
-Xmx2048m

修改后,在 Eclipse 中打开:

Help -> About Eclipse IDE -> Installation Details -> Configuration

确认实际使用的运行时已经改变。不要只查看系统的 java -version,Eclipse 可能使用的是自带 JRE。

如果课程没有严格限制 Eclipse 版本,也可以用更新的 Eclipse 包测试同一个更新站点。只有在新版本安装正常、Eclipse 4.33 又能稳定复现挂起时,才有较充分的依据将问题归到旧版 Equinox/p2 实现。

采集完整线程转储

现有信息只显示安装工作线程正在等待,没有显示负责完成该 CompletableFuture 的线程。需要连续采集几份完整的线程转储:

jcmd
jcmd <PID> Thread.print -l > "$env:TEMP\eclipse-thread-1.txt"
jcmd <PID> Thread.print -l > "$env:TEMP\eclipse-thread-2.txt"
jcmd <PID> Thread.print -l > "$env:TEMP\eclipse-thread-3.txt"

每份间隔约 10 到 20 秒。重点查找:

AuthorityChecker
SignedContent
Certificate
TrustEngine
CompletableFuture
ForkJoinPool
org.eclipse.equinox.p2
FileInputStream
Socket
SSLSocket

可以按以下情况判断:

  • 如果某个线程持续停在 Socket、SSLSocket 或证书撤销检查中,先调查网络、代理和 HTTPS inspection。
  • 如果线程持续停在 JAR 或临时文件读取中,检查安全软件、文件锁和损坏缓存。
  • 如果所有相关工作线程都在等待,而且没有线程执行对应任务,可能是 p2 的异步调度问题。
  • 如果连续转储中的调用栈仍在变化,说明任务还在运行,只是速度很慢,未必发生了死锁。

同时保留 Eclipse workspace 下的日志:

<workspace>\.metadata\.log

启动 Eclipse 时可以增加控制台日志:

eclipse.exe -consolelog

如果需要排除工作区状态的影响,也可以测试:

eclipse.exe -clean -clearPersistedState -consolelog

-clean 会重建部分运行时缓存,但无法修复网络故障,也不保证清除共享的 p2 bundle pool。

使用 p2 director 区分 UI 与底层问题

Eclipse 自带的 p2 director 可以绕过安装向导,直接列出更新站点中的 installable units:

eclipsec.exe -nosplash -consolelog `
  -application org.eclipse.equinox.p2.director `
  -repository "https://更新站点地址/" `
  -list

如果该命令同样挂起,问题出在 p2、JDK、网络或本地安全环境,而非安装向导界面。如果 -list 正常,实际安装却会挂起,则要继续检查下载后的 artifact 和签名验证过程。

实际安装需要准确的 IU ID、目标目录和 profile,插件的显示名称不能代替 IU ID。应先从 -list 输出中确认 IU,再按当前 Eclipse 配置填写参数,以免将错误的 IU 配置误判为新故障。

建议的处理顺序

可以按以下顺序操作:

  1. 禁用无关软件站点,取消 Contact all update sites...,逐个安装插件。
  2. 检查 Network Connections,并用 PowerShell 请求更新站点。
  3. 换用不经过学校或公司代理的网络测试。
  4. 使用全新的 Eclipse 目录和空 workspace 测试。
  5. 检查共享 p2 缓存和安全软件日志。
  6. 换用较新的 Java 21 补丁版本。
  7. 条件允许时,测试更新的 Eclipse 发行版。
  8. 如果仍能复现,提交三份连续的完整线程转储、.metadata\.log、更新站点 URL 和最小复现步骤。

现有证据不支持将问题简单归因于“没有信任所有 authorities”。需要继续确认 AuthorityChecker 等待的异步证书任务为何一直没有完成。

备注:内容仅供参考。