Jenkins上Maven maven-resources-plugin重复执行问题求助

问题概述 #

基于Maven的项目，本地编译时某模块的maven-resources-plugin等插件仅执行1次且构建正常；但在Jenkins中执行命令：

mvn -e -X clean source:jar package install deploy -Pint

时，该模块的对应插件被调用3次，且出现资源加载失败的问题，此问题仅在Jenkins环境复现。

排查方向与解决方案 #

1. 对齐本地与Jenkins的Maven版本 #

不同Maven版本对插件生命周期的绑定逻辑可能存在差异，这是跨环境构建不一致的常见原因：

• 在本地和Jenkins执行机器上分别运行mvn -v，确认Maven、Java版本完全一致
• 若版本不同，调整Jenkins的Maven配置，使用与本地一致的版本后重新构建

2. 清理Jenkins工作空间缓存 #

Jenkins工作空间的残留文件、缓存可能干扰Maven构建流程，导致插件重复触发：

• 在Jenkins构建任务中开启「Delete workspace before build starts」选项，彻底清理后重新执行构建
• 若无法开启该选项，可在构建命令前添加rm -rf target/或mvn clean -U强制更新快照依赖并清理本地构建产物

3. 简化Maven构建命令 #

当前命令包含package install deploy三个重叠的生命周期目标，外加source:jar可能额外触发资源处理阶段，导致插件重复执行：

• 将命令简化为mvn -e -X clean source:jar deploy -Pint（deploy阶段已包含install和package的所有操作）
• 观察简化后插件的执行次数是否恢复正常

4. 校验Profile的环境一致性 #

-Pint激活的Profile可能在Jenkins和本地环境中存在生效差异，进而影响插件执行：

• 在Jenkins中添加前置构建步骤，执行mvn help:active-profiles -Pint，对比本地激活的Profile列表，确认无差异
• 检查父pom.xml和模块pom.xml的<profiles>配置，查看int Profile是否存在重复绑定maven-resources-plugin的逻辑，或资源路径配置是否依赖Jenkins特定环境变量

5. 检查插件的重复绑定配置 #

查看模块pom.xml的<build>节点及父pom的相关配置，确认是否存在插件重复绑定的情况：

• 检查maven-resources-plugin的<executions>节点，是否有多个execution绑定了相同/重叠的生命周期阶段（如process-resources、compile等）
• 若存在重复绑定，删除冗余的execution配置，确保插件仅在目标阶段执行一次

6. 排查Jenkins构建方式的干扰 #

若使用Jenkins的Maven插件构建而非原生Shell命令，可能存在额外的触发逻辑：

• 切换为Shell命令执行Maven构建，排除Jenkins Maven插件的内置逻辑干扰
• 检查Jenkins Maven插件的配置，确认未勾选「Execute goals before build」等可能重复触发构建步骤的选项

资源加载失败的针对性排查 #

结合错误日志中的[pathconvert] Set property core.file.full.path = ...，重点关注：

• 资源文件在Jenkins工作空间中的路径是否正确，是否因权限不足、路径拼接错误导致无法访问
• 查看-X参数输出的完整调试日志，定位插件第三次执行时的触发阶段和具体失败的资源路径，确认是否为Profile中配置的路径与Jenkins环境不匹配
• 检查是否存在针对本地环境的硬编码路径，未适配Jenkins的工作空间结构

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