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 正在读取签名,可能会长时间等待。
可以进行一次受控测试:
- 退出 Eclipse。
- 确认没有残留的
javaw.exe或 Eclipse 安装任务。 - 将 Eclipse 解压到普通的本地目录,例如
C:\Tools\eclipse。 - 使用一个新的空 workspace。
- 临时为 Eclipse 安装目录和 p2 缓存目录设置安全软件排除项。
- 只安装一个插件。
仅在确认插件来源可信时进行这项测试,测试结束后恢复安全软件配置。如果设置排除项后安装恢复正常,再结合安全软件日志,制定范围更小的目录或进程规则。
使用干净安装和新的 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 配置误判为新故障。
建议的处理顺序
可以按以下顺序操作:
- 禁用无关软件站点,取消
Contact all update sites...,逐个安装插件。 - 检查
Network Connections,并用 PowerShell 请求更新站点。 - 换用不经过学校或公司代理的网络测试。
- 使用全新的 Eclipse 目录和空 workspace 测试。
- 检查共享 p2 缓存和安全软件日志。
- 换用较新的 Java 21 补丁版本。
- 条件允许时,测试更新的 Eclipse 发行版。
- 如果仍能复现,提交三份连续的完整线程转储、
.metadata\.log、更新站点 URL 和最小复现步骤。
现有证据不支持将问题简单归因于“没有信任所有 authorities”。需要继续确认 AuthorityChecker 等待的异步证书任务为何一直没有完成。
备注:内容仅供参考。
