Maven多模块项目：如何让SonarQube识别React前端LCOV覆盖率？

针对你的Maven多模块项目结构（根pomfcs→fcs-react-web→backend/frontend），后端覆盖率正常但前端始终显示0%的情况，可按以下步骤排查修复：

1. 确保覆盖率文件路径配置绝对可靠 #

在frontend/pom.xml中，将sonar.javascript.lcov.reportPaths改为基于Maven项目根目录的动态路径，避免相对路径的歧义：

<properties>
  <sonar.javascript.lcov.reportPaths>${project.basedir}/coverage/lcov.info</sonar.javascript.lcov.reportPaths>
</properties>

${project.basedir}会自动指向frontend模块的根目录，确保Sonar能精准定位到覆盖率文件。

2. 绑定Jest测试到Maven的verify阶段 #

如果前端测试不是自动执行的，必须保证Sonar扫描前已生成覆盖率文件。在frontend/pom.xml中配置exec-maven-plugin，把jest --coverage绑定到verify阶段：

<build>
  <plugins>
    <plugin>
      <groupId>org.codehaus.mojo</groupId>
      <artifactId>exec-maven-plugin</artifactId>
      <version>3.1.0</version>
      <executions>
        <execution>
          <id>jest-test</id>
          <phase>verify</phase>
          <goals>
            <goal>exec</goal>
          </goals>
          <configuration>
            <executable>npx</executable>
            <arguments>
              <argument>jest</argument>
              <argument>--coverage</argument>
            </arguments>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

这样执行mvn verify时会自动运行前端测试并生成覆盖率文件，无需手动操作。

3. 指定前端源码的扫描范围 #

如果frontend模块的packaging是默认的jar（Java模块类型），Sonar会默认扫描src/main/java目录，不会识别前端文件。需在frontend/pom.xml中明确配置Sonar的源码和测试目录：

<properties>
  <!-- 前端源码目录，根据实际结构调整 -->
  <sonar.sources>src</sonar.sources>
  <!-- 前端测试文件目录，比如src/__tests__ -->
  <sonar.tests>src/__tests__</sonar.tests>
  <!-- 排除不需要扫描的目录 -->
  <sonar.exclusions>node_modules/**</sonar.exclusions>
</properties>

这是关键步骤——Sonar只有明确哪些是前端源码，才能将覆盖率数据匹配到对应文件上。

4. 检查lcov.info中的文件路径是否匹配 #

打开frontend/coverage/lcov.info，查看SF:开头的行（如SF:src/App.js），确认路径是相对于frontend模块根目录的相对路径，而非绝对路径。如果是绝对路径，修改jest.config.js生成相对路径：

module.exports = {
  // 确保覆盖率报告使用相对路径
  coverageReporters: [
    'lcov',
    { type: 'lcov', projectRoot: './' }
  ],
  // 锁定rootDir为当前模块根目录
  rootDir: '.'
};

路径不匹配时，Sonar无法关联覆盖率数据与源码文件，就会显示0%。

5. 确认SonarQube插件版本兼容性 #

确保SonarQube服务器上的JavaScript/TypeScript插件版本≥9.0，旧版本可能不兼容新版本Jest生成的lcov格式。可在SonarQube后台「市场」中检查并升级插件。

6. 验证扫描命令的模块范围 #

执行扫描时，可先单独测试前端模块的扫描结果，排查全局配置问题：

mvn -f fcs/pom.xml verify sonar:sonar -pl fcs-react-web/frontend

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