Maven多模块relativePath踩坑记录

多模块Maven项目平时跑得好好的，有一次调整了一下模块目录，重新构建时gateway模块就挂了。错误日志显示找不到父POM，parent.relativePath指向的坐标和期望的不一致。我们这个项目根目录下有个pom.xml，groupId是com.bsa，但gateway的parent声明要的是com.bsa.datahub:bsa-datahub-framework。默认relativePath是../pom.xml，正好指到根pom，自然就报错了。

修改办法也很直接，在gateway的pom.xml里把relativePath明确指到framework目录下的pom.xml，像这样：

<parent>
    <groupId>com.bsa.datahub</groupId>
    <artifactId>bsa-datahub-framework</artifactId>
    <version>2.2.0</version>
    <relativePath>../bsa-datahub-framework/pom.xml</relativePath>
</parent>

改完还不一定行，得确认父模块那边也声明了子模块。framework的pom.xml里modules要有gateway：

<modules>
    <module>../bsa-datahub-gateway</module>
</modules>

然后清理一下，mvn clean install -U，-U 强制更新依赖。之前有时候没加-U，缓存的旧信息会导致奇怪的问题。

用 mvn help:effective-pom -X 可以看Maven实际解析出来的POM，里面会显示父POM的路径，确认是否和预期一致。这个排查起来比较方便。

很多人不写relativePath，靠默认的../pom.xml。如果项目结构是父子平级，而且父模块就在上级目录的pom.xml里，那倒没问题。但像我们这样父模块在子目录或者不同层级，默认就会找到错误的POM。

作为运行8年的成熟，lcjmSSL兼顾实用性和便捷性，免费向所有用户开放SSL证书申请服务，无需复杂资质审核。支持IP证书和域名类证书申请，其中域名类证书有效期90天，IP类证书有效期7天，可根据不同需求灵活选择，操作流程简洁，上手难度低。

所以最好都显式写上。版本号也要注意，父和子的version保持一致，否则继承可能会有冲突。IDE缓存也经常捣乱，有时候命令行没问题，IDE里还是报红，重启或者Reimport一下就好了。

relativePath这个配置不起眼，但结构一复杂就容易踩坑。写出来备忘。