从Eclipse RCP 4.15迁移至4.26后应用启动异常求助

核心问题分析 #

开发环境正常但构建后启动失败，本质是构建产物的OSGi元数据不完整、旧版本缓存干扰，以及手动引入felix fileinstall后和Eclipse原生启动逻辑冲突导致类加载异常。

分步解决方案 #

1. 修复InstallAnyWhere构建的目标平台与元数据问题 #

• 确保InstallAnyWhere使用的目标平台和开发环境完全一致：
  • 导出开发环境的目标平台文件（.target），在InstallAnyWhere构建流程中直接引用，避免手动依赖遗漏。
  • 构建时强制重新生成OSGi的bundle.info和configuration/config.ini，不要复用旧构建脚本中的模板文件。
• 验证构建产物的plugins目录：
  • 检查所有插件的版本是否为4.26对应版本，无4.15残留插件。
  • 确认每个插件的MANIFEST.MF中Bundle-Version、Export-Package、Import-Package字段完整且无版本冲突。

2. 移除felix fileinstall，恢复Eclipse原生启动逻辑 #

手动引入felix fileinstall会打乱Eclipse RCP的原生启动顺序和类加载机制，导致org.eclipse.core.runtime等核心插件类加载异常。需：

• 删除config.ini中的osgi.bundles=org.apache.felix.fileinstall@1:start配置。
• 移除eclipse.ini中所有-Dfelix.fileinstall.*相关参数。
• 确保config.ini中保留Eclipse原生的启动配置：

  osgi.bundles=reference:file:org.eclipse.equinox.common@2:start,reference:file:org.eclipse.update.configurator@3:start,reference:file:org.eclipse.core.runtime@start
  osgi.bundles.defaultStartLevel=4
  

3. 处理旧版本缓存问题 #

无需手动清理用户AppData，可在构建时添加自动清理缓存的逻辑：

• 在eclipse.ini中添加参数：

  -clearPersistedState
  

  该参数会在启动时自动清理旧的OSGi状态缓存，避免新旧版本插件冲突。
• 若需要更彻底的缓存清理，可在应用启动前添加脚本（Windows批处理/Shell脚本），自动删除用户目录下的旧缓存文件夹（通常位于%APPDATA%\<你的产品名>或~/.eclipse/<你的产品名>）。

4. 排查org.eclipse.equinox.http.jetty类加载异常 #

该异常通常是因为插件依赖缺失或版本不匹配：

• 在开发环境的Run Configuration中，检查org.eclipse.equinox.http.jetty插件的所有依赖是否都被包含在构建产物中。
• 确认构建产物中存在org.eclipse.equinox.http.jetty的依赖插件，比如org.eclipse.jetty.*系列插件，且版本与4.26目标平台一致。
• 若使用了自定义的产品配置（.product文件），确保在Dependencies标签页中已勾选org.eclipse.equinox.http.jetty及其所有必需依赖。

5. 验证构建流程 #

• 使用Eclipse自带的Tycho插件重新构建，对比InstallAnyWhere的构建产物，确认差异点，定位InstallAnyWhere构建脚本中的遗漏配置。
• 构建后使用osgi console启动应用，执行ss命令查看插件状态，执行diag <插件ID>命令排查具体的依赖缺失问题：
  在eclipse.ini中添加启动参数：

  -console
  

  启动后在控制台输入：

  ss
  diag org.eclipse.equinox.http.jetty
  

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