Jenkins中Maven子模块构建失败求助：本地正常Jenkins提示模块不存在

你遇到的这个情况其实挺典型的——本地能正常构建，但Jenkins跑起来就报子模块找不到，大概率是Jenkins工作区的目录结构、代码拉取配置或者路径解析逻辑和本地不一致导致的。下面给你几个具体的排查和解决方向：

1. 先确认Jenkins工作区的实际目录结构 #

登录Jenkins所在的服务器，直接导航到报错里的路径/home/jenkins/workspace/TEST，手动查看里面是否真的存在A/B这个子目录。很多时候问题出在代码拉取环节：比如Git克隆时没拉全子模块、或者Jenkins的SCM配置漏了递归拉取的选项，都会导致子目录缺失。

2. 检查根pom.xml的子模块路径配置 #

打开本地的TEST/pom.xml，找到<modules>标签下的配置。要确保子模块的路径是相对于根pom的相对路径，比如正确的写法应该是：

<modules>
    <module>A/B</module>
</modules>

如果本地配置的是绝对路径（比如<module>/本地路径/A/B</module>），那Jenkins肯定找不到——毕竟它的工作区路径和你的本地路径完全不一样。

3. 排查Jenkins的代码拉取配置 #

• 如果你用的是Git作为代码仓库，要确认Jenkins的Git插件是否勾选了「Recursively clone submodules」选项（如果你的子模块是Git子模块的话），这个选项会确保克隆时拉取所有嵌套的子模块内容。
• 尝试清理Jenkins工作区后重新构建：在Jenkins项目页面点击「Workspace」→「Delete workspace」，然后重新触发构建，避免旧的缓存目录干扰。

4. 在Jenkins服务器手动执行构建测试 #

去到Jenkins的工作区目录/home/jenkins/workspace/TEST，手动执行mvn clean install命令。如果手动执行也报同样的错，那就是目录结构或pom配置的问题；如果手动能正常构建，那可能是Jenkins的构建配置出了问题——比如构建时的工作目录设置不正确，或者Maven的执行参数有差异。

5. 确认Jenkins的Maven版本和本地一致 #

不同版本的Maven对模块路径的解析逻辑可能存在细微差异。在Jenkins项目配置的「Maven Version」选项里，选择和你本地使用的相同版本，再重新构建试试。

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