GitHub托管的Maven多模块项目是否需在子模块重复SCM配置？

问题场景 #

以GitHub托管的JavaFX多模块项目为例，父POM（org.openjfx:javafx）中定义了完整的SCM配置：

<project>
    <url>https://openjdk.java.net/projects/openjfx/</url>

    <scm>
        <connection>scm:git:git://github.com/openjdk/jfx.git</connection>
        <developerConnection>scm:git:ssh://github.com:openjdk/jfx.git</developerConnection>
        <url>https://github.com/openjdk/jfx</url>
    </scm>
    ...
</project>

而子模块javafx-controls的POM仅重复了<url>，未配置SCM：

<project>
    <url>https://openjdk.java.net/projects/openjfx/</url>
    ...
</project>

这导致Maven Central上javafx-controls的源码控制链接被自动拼接为https://github.com/openjdk/jfx/javafx-controls，访问时出现404错误。

核心疑问：对于GitHub托管的多模块Maven项目，是推荐在子模块中重复配置SCM以避免链接失效，还是仅在父POM定义SCM并接受该问题，以此规避源码仓库操作的潜在风险？

解答 #

1. 推荐方案：子模块显式配置SCM（通过父POM属性简化） #

Maven官方没有强制要求子模块重复SCM配置，但针对GitHub托管的项目，显式在子模块中配置SCM是更合理的选择——可以避免Maven自动拼接错误的链接，同时通过父POM定义公共属性来减少代码重复：

父POM中定义SCM属性

<properties>
    <scm.base-url>https://github.com/openjdk/jfx</scm.base-url>
    <scm.connection>scm:git:git://github.com/openjdk/jfx.git</scm.connection>
    <scm.developer-connection>scm:git:ssh://github.com:openjdk/jfx.git</scm.developer-connection>
</properties>

子模块中引用属性配置SCM

<scm>
    <connection>${scm.connection}</connection>
    <developerConnection>${scm.developer-connection}</developerConnection>
    <url>${scm.base-url}</url>
</scm>

这种方式既保证了子模块SCM链接的正确性，又避免了重复编写配置代码。

2. 不建议接受默认行为 #

Maven Central上的源码链接是开发者查找项目源码的关键入口，404错误会直接降低用户体验，甚至误导用户认为项目源码缺失。另外，GitHub仓库内的子模块目录（而非Git子模块）不存在父仓库URL/子模块名这样的直接访问路径，Maven自动拼接的链接本身就是错误的，无法指向正确的源码位置。

3. 源码仓库操作风险的误区 #

担心重复SCM配置会引发仓库操作问题是不必要的。Maven的SCM配置仅用于声明源码的公开位置，不会影响实际的Git操作（如拉取、提交、推送）。只要配置的属性与父POM保持一致，子模块的SCM配置不会带来任何额外风险。

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