如何在Sonar中为Maven多模块项目创建子项目结构

我来帮你搞定这个问题！之前我也踩过类似的坑，要让Maven多模块项目在Sonar里呈现为一个顶级项目下的子模块结构，关键是统一父级配置和正确触发分析，具体步骤如下：

1. 统一父级POM的Sonar配置 #

首先在你的Maven父项目根目录的pom.xml中添加全局Sonar属性，确保所有子模块共享同一个顶级项目标识：

<properties>
    <!-- 顶级项目的唯一Key，所有子模块会关联到这个Key下 -->
    <sonar.projectKey>your-company:top-level-project</sonar.projectKey>
    <!-- 顶级项目显示名称 -->
    <sonar.projectName>我的Maven多模块项目</sonar.projectName>
    <!-- 可选：显式指定子模块列表，Sonar也会自动扫描Maven的module配置 -->
    <sonar.modules>user-service,order-service,common-utils</sonar.modules>
</properties>

⚠️ 重要提示：所有子模块的pom.xml中不要单独设置sonar.projectKey，让它们继承父项目的配置，否则Sonar会把每个子模块识别为独立项目。

2. 在父项目根目录触发Sonar分析 #

必须在父项目根目录下执行Sonar分析命令，而不是逐个在子模块执行。这样Sonar插件会自动关联所有子模块的分析结果到顶级项目：

# 先执行构建验证，再触发Sonar分析
mvn clean verify sonar:sonar \
  -Dsonar.host.url=http://你的Sonar服务器地址 \
  -Dsonar.login=你的Sonar令牌（如果开启了认证）

执行完成后，Sonar会自动为顶级项目创建子模块节点，结构和你本地Maven多模块完全匹配。

3. 清理已存在的独立子模块项目（可选） #

如果你之前已经在Sonar中创建了各个子模块的独立项目，可以根据需求处理：

• 如果不需要这些独立项目的历史数据，直接在Sonar后台删除即可；
• 如果需要保留历史数据，部分Sonar版本支持项目合并功能（需管理员权限），可以在Sonar后台找到对应子项目的设置，选择合并到顶级项目下。

4. 验证结果 #

登录Sonar服务器，找到你的顶级项目，进入后在左侧导航栏会看到「模块」选项，点击即可查看各个子模块的代码质量、覆盖率等分析数据，完美还原本地Maven的模块结构。

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