GitLab CI/CD中sonar-project.properties覆盖率排除规则不生效问题

在GitLab CI/CD部署的多模块SpringBoot项目（Test-Service目录下包含user-service、async-service、audit-service三个子服务）中，根目录Test-Service下的sonar-project.properties配置的sonar.coverage.exclusions规则未生效，导致SonarQube质量门因覆盖率不达标失败；但将该规则直接作为Maven命令行参数时可正常工作。以下是具体原因及解决方法：

1. 多模块项目的配置作用域问题 #

SonarQube Maven插件处理多模块项目时，默认尝试将根目录的sonar-project.properties应用到所有子模块，但部分场景下插件执行逻辑会优先读取子模块上下文，导致根配置未被正确传递。

解决方法：
在根pom.xml的<properties>节点中配置Sonar参数，确保所有子模块继承该配置：

<properties>
  <sonar.coverage.exclusions>**/com/cadmium/async/business/config/*,**/com/cadmium/async/business/domain/*,**/com/cadmium/audit/business/config/*,**/com/cadmium/audit/business/domain/*,**/com/cadmium/user/business/config/*,**/com/cadmium/user/business/domain/*</sonar.coverage.exclusions>
</properties>

2. 配置文件路径未被正确识别 #

GitLab CI流水线的工作目录可能不是Test-Service目录，Sonar插件默认在当前工作目录查找sonar-project.properties，导致无法读取到Test-Service下的配置文件。

解决方法：
在Maven命令中指定项目根目录参数，让Sonar插件定位到正确的配置文件路径：

mvn --batch-mode verify sonar:sonar -Dsonar.host.url=sonar-url -Dsonar.login=admin -Dsonar.password=admin -Denv="$PROFILE" -Dsonar.projectBaseDir=./Test-Service -Dsonar.qualitygate.wait=true

3. SonarQube Maven插件版本兼容性问题 #

旧版本的SonarQube Maven插件对多模块项目中sonar-project.properties的支持存在缺陷，导致根目录的排除规则未被解析。

解决方法：
升级SonarQube Maven插件至最新稳定版本，在根pom.xml中指定插件版本：

<build>
  <pluginManagement>
    <plugins>
      <plugin>
        <groupId>org.sonarsource.scanner.maven</groupId>
        <artifactId>sonar-maven-plugin</artifactId>
        <version>3.10.0.2594</version> <!-- 替换为最新官方稳定版本 -->
      </plugin>
    </plugins>
  </pluginManagement>
</build>

4. 参数优先级冲突 #

SonarQube参数的优先级顺序为：命令行参数 > Maven pom.xml属性 > sonar-project.properties。如果子模块pom.xml或全局Maven配置（settings.xml）中存在重复的sonar.coverage.exclusions配置，会覆盖根目录sonar-project.properties的规则。

解决方法：
检查所有子模块的pom.xml及全局Maven配置文件，移除重复的sonar.coverage.exclusions配置，确保根配置生效。

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