Maven多模块配置本地正常，Jenkins构建报错模块文件不存在

核心原因 #

本地构建正常但Jenkins报错，本质是Jenkins工作区的目录结构和本地不一致：

• 本地parent、child1、child2是同级目录，../child1/pom.xml这类相对路径能正常解析；
• Jenkins默认只拉取parent项目代码，不会自动同步同级的child1和child2，导致工作区中不存在这两个子模块的文件，自然触发“文件不存在”的错误。
  另外你的pom.xml里存在路径拼写错误：<module>../child2.pom.xml</module>应该改为<module>../child2/pom.xml</module>（少了斜杠），这也可能加剧问题。

解决方案 #

1. 同步Jenkins工作区目录结构（推荐） #

在Jenkins任务中添加多个源码拉取步骤，确保child1、child2和parent处于同级目录：

• 第一步：拉取parent项目，指定目标目录为parent；
• 第二步：拉取child1项目，指定目标目录为child1；
• 第三步：拉取child2项目，指定目标目录为child2；
  这样Jenkins工作区的目录结构和本地完全一致，相对路径就能正常生效。

2. 调整Jenkins构建工作目录 #

在Jenkins任务的高级设置中，将构建工作目录设置为parent项目的上级目录。这样../child1就能指向正确的子模块路径，但这种方式不如第一种直观，后续维护容易出问题。

3. 修复pom.xml路径错误 #

将错误的子模块路径：

<module>../child2.pom.xml</module>

修正为：

<module>../child2/pom.xml</module>

避免因拼写错误导致的文件查找失败。

4. 使用MultiSCM插件批量拉取（可选） #

若Jenkins已安装MultiSCM插件，可在单个任务中同时配置多个代码仓库的拉取，指定每个仓库的目标目录，快速实现同级目录结构。

验证流程 #

1. 先修正pom.xml中的路径拼写错误；
2. 配置Jenkins任务拉取所有相关项目，确保目录结构与本地一致；
3. 重新执行构建，检查错误是否消除。

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