解决 SonarQube 中 JaCoCo 代码覆盖率显示为 0% 的问题

<properties>
    <java.version>1.8</java.version>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

    <!-- JaCoCo .exec 文件路径，用于存储运行时覆盖率数据 -->
    <jacoco.exec.file>${project.build.directory}/jacoco.exec</jacoco.exec.file>
    <!-- JaCoCo XML 报告输出目录 -->
    <jacoco.report.dir>${project.build.directory}/jacoco_report</jacoco.report.dir>

    <!-- SonarQube 相关的报告路径配置 -->
    <sonar.surefire.reportsPath>${project.build.directory}/surefire-reports</sonar.surefire.reportsPath>
    <sonar.coverage.jacoco.xmlReportPaths>${jacoco.report.dir}/jacoco.xml</sonar.coverage.jacoco.xmlReportPaths>
</properties>

<build>
    <plugins>
        <!-- Maven Surefire Plugin -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>2.22.2</version> <!-- 建议使用较新且稳定的版本 -->
            <configuration>
                <!-- 关键：使用 JaCoCo prepare-agent 目标设置的 JVM 参数 -->
                <argLine>${surefireArgLine}</argLine>
                <!-- Surefire 报告输出目录 -->
                <reportsDirectory>${sonar.surefire.reportsPath}</reportsDirectory>
            </configuration>
        </plugin>
        <!-- ... 其他插件 ... -->
    </plugins>
</build>

<build>
    <plugins>
        <!-- ... Surefire 插件配置 ... -->

        <!-- JaCoCo Maven Plugin -->
        <plugin>
            <groupId>org.jacoco</groupId>
            <artifactId>jacoco-maven-plugin</artifactId>
            <version>0.8.6</version> <!-- 确保版本与 SonarQube 兼容，或使用最新稳定版 -->
            <executions>
                <!-- 1. prepare-agent 目标：在测试运行前准备 JaCoCo 代理 -->
                <execution>
                    <id>prepare-agent</id>
                    <goals>
                        <goal>prepare-agent</goal>
                    </goals>
                    <configuration>
                        <!-- 指定 .exec 文件的生成路径 -->
                        <destFile>${jacoco.exec.file}</destFile>
                        <!-- 定义一个属性，用于 Surefire 插件的 argLine -->
                        <propertyName>surefireArgLine</propertyName>
                    </configuration>
                </execution>
                <!-- 2. report 目标：在测试运行后生成 XML 报告 -->
                <execution>
                    <id>report</id>
                    <phase>post-unit-test</phase> <!-- 确保在单元测试完成后执行 -->
                    <goals>
                        <goal>report</goal>
                    </goals>
                    <configuration>
                        <!-- 指定输入 .exec 文件，即 prepare-agent 生成的文件 -->
                        <dataFile>${jacoco.exec.file}</dataFile>
                        <!-- 指定 XML 报告的输出目录 -->
                        <outputDirectory>${jacoco.report.dir}</outputDirectory>
                        <!-- 明确指定生成 XML 格式报告 -->
                        <formats>
                            <format>XML</format>
                        </formats>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

pipeline {
    agent any
    stages {
        stage('Build and Test') {
            steps {
                script {
                    // 清理、编译、运行测试并生成 JaCoCo .exec 数据和 XML 报告。
                    // 'verify' 阶段会包含 'test' 阶段和 'post-unit-test' 阶段（JaCoCo report 目标绑定在此）。
                    // 确保所有测试都运行，并且 JaCoCo 报告被生成。
                    sh 'mvn clean verify'
                }
            }
        }
        stage('SonarQube Analysis') {
            steps {
                script {
                    // 确保此处的报告路径与 pom.xml 中 JaCoCo 插件实际生成 XML 报告的路径一致。
                    // 对应 pom.xml 中 <sonar.coverage.jacoco.xmlReportPaths> 的值
                    def jacocoXmlReportPath = "target/jacoco_report/jacoco.xml"

                    sh "mvn sonar:sonar " +
                       "-Dsonar.projectKey=your_project_key " + // 替换为您的 SonarQube 项目 Key
                       "-Dsonar.sources=src/main/java " +
                       "-Dsonar.java.binaries=target/classes " + // 明确指定 Java 字节码目录
                       "-Dsonar.host.url=http://192.168.2.2:9000/ " + // 您的 SonarQube 服务器地址
                       "-Dsonar.login=admin " + // SonarQube 认证令牌或用户名
                       "-Dsonar.password=sonar " + // SonarQube 认证密码 (生产环境建议使用令牌)
                       "-Dsonar.coverage.jacoco.xmlReportPaths=${jacocoXmlReportPath}" // 关键：指定 JaCoCo XML 报告路径
                }
            }
        }
    }
}