排查Eclipse RCP产品构建添加m2e.wtp后自定义丢失问题

1. 先确认构建产物的完整性 #

• 解压构建后的产品包（路径一般为target/products/xxx），检查plugins文件夹中你的自定义品牌插件（包含视角、启动画面、图标的插件）是否存在，版本是否匹配预期。
• 同时查看features目录，确认包含这些自定义插件的feature是否被正确打包进来。
• 执行mvn clean install -X开启Maven调试日志，搜索自定义插件的artifactId，排查构建过程中是否有插件被跳过、排除或出现依赖解析失败的情况。

2. 校验产品定义的依赖与配置 #

• 打开.product文件的Dependencies标签：
  • 确保你的自定义feature/plugin在依赖列表中，且未勾选Optional选项
  • 检查依赖过滤规则，确认m2e相关依赖没有意外排除你的自定义插件
• 切换到Configuration标签，确认自定义插件的Start Levels设为合理值（比如default），且Auto-Start设置为true

3. 启动时抓取日志排查插件加载问题 #

• 启动Eclipse时添加参数：-consoleLog -debug，输出详细的插件加载日志。
• 在日志中搜索自定义插件ID，排查是否存在BundleException、MissingConstraint这类导致插件加载失败的错误。
• 附带-clean参数启动，清除缓存的配置信息，避免旧状态干扰测试结果。

4. 排查m2e集成的兼容性与冲突 #

• 确认m2e.wtp版本与你的Eclipse基础版本匹配（比如Eclipse 2023-06对应m2e.wtp 2.0.x系列）
• 打开.target目标平台文件，调整仓库顺序，将你的自定义插件仓库放在m2e仓库之前，避免优先级被覆盖导致插件无法被选中。
• 检查pom.xml的Tycho配置，看是否有excludePlugins等规则无意中过滤了自定义插件。

5. 对比集成前后的配置差异 #

• 对比添加m2e依赖前后的target/platform目录，查看自定义插件的JAR是否存在，以及它们的MANIFEST.MF文件是否被意外修改。
• 检查自定义插件的plugin.xml，确认视角、扩展点等定义没有被m2e的扩展覆盖或未激活。

6. 简化环境做二分测试 #

• 临时移除m2e.wtp依赖，重新构建并启动，确认自定义内容是否恢复，以此锁定问题根源确实来自m2e集成。
• 若确定是m2e的问题，先只添加核心m2e插件，再逐步引入m2e.wtp组件，排查具体是哪个组件引发的冲突。

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