在Maven多模块项目的开发过程中，子模块构建时提示父POM未找到是较为常见的报错问题，该错误会直接中断构建流程，影响项目的正常编译和打包。这类错误的核心原因是子模块无法正确定位或获取父POM的相关信息，通常和配置参数、项目结构、本地仓库状态等因素相关。
常见错误触发场景
父POM路径配置错误
子模块的pom.xml中<parent>标签的<relativePath>参数设置不正确，是引发该错误的主要原因之一。如果父POM不在子模块的默认相对路径下，却没有手动指定正确的路径，Maven就无法找到对应的父POM文件。
父POM版本号不匹配
子模块中声明的父POM版本号和实际父POM的版本号不一致时，Maven在本地仓库或远程仓库查找对应版本的父POM时会失败，从而抛出父POM未找到的错误。
本地仓库未安装父模块
如果父模块没有先安装到本地Maven仓库，直接构建子模块时，Maven无法从本地仓库获取父POM的信息，也会触发该错误，这种情况在新建多模块项目首次构建时尤为常见。
排查与解决步骤
检查relativePath配置
首先打开子模块的pom.xml文件，查看<parent>标签下的<relativePath>配置。如果父POM和子模块在同一项目目录下，正确的配置示例如下：
<parent>
<groupId>com.example</groupId>
<artifactId>parent-project</artifactId>
<version>1.0.0</version>
<relativePath>../pom.xml</relativePath>
</parent>
如果父POM就在子模块的上一级目录，<relativePath>可以设置为../pom.xml，如果父POM和子模块在同一目录层级，则设置为./pom.xml，如果不需要从相对路径查找，也可以删除该标签，让Maven直接从本地仓库查找。
核对父POM版本号
确认子模块中<parent>标签的<version>和父POM文件根节点下的<version>完全一致，包括快照版本的标识也要匹配，比如父POM版本是1.0.0-SNAPSHOT，子模块中不能写成1.0.0。
先安装父模块到本地仓库
在父模块的根目录下执行Maven安装命令，将父POM安装到本地仓库：
mvn clean install -DskipTests
安装完成后再进入子模块目录执行构建命令，即可正常找到父POM。
清理本地仓库缓存
如果本地仓库中父POM的缓存文件损坏，也会导致查找失败，可以进入本地Maven仓库的对应路径，删除父POM相关的文件夹，然后重新执行安装命令。
验证解决效果
完成上述配置调整和安装操作后，重新执行子模块的构建命令：
mvn clean package -DskipTests
如果构建过程不再提示父POM未找到的错误，且能正常完成编译打包，说明问题已经解决。如果仍然报错，可以进一步检查项目的<groupId>和<artifactId>是否和父POM的声明一致，排除标识不匹配的问题。