Eclipse IDE不同环境下同名文件部署选择机制差异咨询

问题表现 #

• 同一套项目代码、纳入版本控制的Eclipse配置在5台测试设备上表现不一致：3台设备部署时同名静态资源优先取Project B自身webapp目录下的文件，符合预期；2台设备始终优先取关联的Project A webapp下的同名文件，不符合预期。
• 异常设备覆盖Eclipse 2019-12（4.14.0）、版本未知的老旧Eclipse Fortune版本；正常设备覆盖Eclipse 2020-03（4.15.0）、Eclipse 2019-06（4.12.0），可排除Eclipse版本直接关联，初步定位为本地Eclipse私有配置差异导致。
• 项目结构说明：Project B编译、部署依赖Project A；两个项目均有独立webapp目录存放静态资源，通过Properties > Resource > Linked Resources将Project A的webapp关联到Project B，实现静态资源跨项目共享。
• 已知规则：项目内.settings/org.eclipse.wst.common.component文件会按Properties > Deployment Assembly中添加的资源顺序记录条目，默认排序靠前的路径内同名文件会被优先部署。异常设备上该文件内容与正常设备完全一致，但优先级规则未生效。

排查步骤与解决方案 #

• 清理WTP工作空间缓存
  Eclipse不会只读取项目级别的配置，工作空间目录下.metadata/.plugins/org.eclipse.wst.common.componentcore/存放的全局配置、旧项目缓存会覆盖项目内的配置。操作步骤：关闭Eclipse，删除该目录下对应Project A、Project B的缓存文件夹，重启Eclipse后执行Project > Clean清理全项目，重新部署验证。
• 校验Linked Resources路径解析逻辑
  异常设备上的路径变量可能被本地自定义覆盖，导致关联路径优先级异常。操作步骤：打开Project B的Properties > Resource > Linked Resources > Path Variables，检查PROJECT_LOC等内置路径变量是否被手动修改；删除现有Project A webapp的关联条目，重新用项目相对路径创建关联，再进入Deployment Assembly页面，将Project B自身的webapp条目拖动到关联资源条目的最上方，保存后清理项目重试。
• 检查服务器适配器发布配置
  若使用Tomcat等Web服务器适配器，异常设备上可能开启了增量发布选项，旧发布缓存未被清理，或服务器级别的模块加载顺序被修改。操作步骤：右键点击Servers视图中绑定的服务器，选择Clean...清理所有发布缓存；进入服务器的Modules配置页，检查Project B的资源加载顺序，确认自身webapp排序在关联资源之前。
• 校验Java构建路径的依赖导出配置
  打开Project B的Properties > Java Build Path > Projects标签，选中依赖的Project A条目，检查右侧Exported复选框是否被异常勾选：该选项勾选后，WTP部署时会将Project A的资源作为优先导出条目插入到部署列表靠前位置，直接覆盖Deployment Assembly中配置的顺序。编译场景下不需要勾选该选项，取消勾选后保存配置重试。
• 排除第三方插件干扰
  异常设备上如果安装了第三方Web开发插件、资源同步类插件，可能篡改WTP默认的资源解析规则。操作步骤：关闭Eclipse，在命令行执行eclipse.exe -clean启动，清理所有插件缓存后验证；如果问题仍存在，可新建一个干净的工作空间，仅保留Eclipse默认的Java EE插件，重新导入项目验证。

每次修改配置后必须执行两步清理操作：一是对关联项目执行Project > Clean，二是对绑定的Web服务器执行Clean清理发布目录，避免增量编译残留的旧缓存干扰验证结果。

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