Spring Boot中Rest Assured测试JaCoCo代码覆盖不全问题

核心原因是**@SpringBootTest默认启动的嵌入式服务器与测试代码分属不同JVM**，JaCoCo Agent仅在测试JVM中运行，无法收集到应用JVM里Controller端点方法的执行数据。以下是具体解决方法：

1. 核心配置：确保测试与应用同JVM运行 #

修改Maven Surefire/Failsafe和JaCoCo插件配置，强制测试不fork新进程，同时传递JaCoCo Agent参数到应用JVM：

<build>
    <plugins>
        <!-- JaCoCo 插件配置 -->
        <plugin>
            <groupId>org.jacoco</groupId>
            <artifactId>jacoco-maven-plugin</artifactId>
            <version>0.8.11</version>
            <executions>
                <execution>
                    <id>pre-test</id>
                    <goals>
                        <goal>prepare-agent</goal>
                    </goals>
                    <configuration>
                        <!-- 自定义Agent参数变量，避免与其他插件冲突 -->
                        <propertyName>jacoco.agent.argLine</propertyName>
                    </configuration>
                </execution>
                <execution>
                    <id>post-test</id>
                    <goals>
                        <goal>report</goal>
                    </goals>
                    <configuration>
                        <dataFile>${project.build.directory}/jacoco.exec</dataFile>
                        <outputDirectory>${project.reporting.outputDirectory}/jacoco</outputDirectory>
                    </configuration>
                </execution>
            </executions>
        </plugin>

        <!-- Surefire 单元测试插件 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.2.5</version>
            <configuration>
                <!-- 传递JaCoCo Agent参数到测试进程 -->
                <argLine>${jacoco.agent.argLine}</argLine>
                <!-- 禁止fork新进程，确保测试与应用同JVM -->
                <forkCount>0</forkCount>
            </configuration>
        </plugin>

        <!-- Failsafe 集成测试插件 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-failsafe-plugin</artifactId>
            <version>3.2.5</version>
            <executions>
                <execution>
                    <goals>
                        <goal>integration-test</goal>
                        <goal>verify</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <argLine>${jacoco.agent.argLine}</argLine>
                <forkCount>0</forkCount>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 测试类优化方案 #

方案一：使用RestAssured MockMvc模式（推荐，无需启动服务器） #

直接绑定Spring MockMvc，在同一个JVM内调用Controller方法，完全避免跨进程问题：

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.web.servlet.MockMvc;
import static io.restassured.module.mockmvc.RestAssuredMockMvc.*;

@SpringBootTest
@AutoConfigureMockMvc
public class UserControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @BeforeEach
    void setUp() {
        // 绑定MockMvc到RestAssured
        mockMvc(mockMvc);
    }

    @Test
    void testGetUserById() {
        given()
            .param("id", 1)
        .when()
            .get("/api/users")
        .then()
            .statusCode(200);
    }
}

方案二：保留嵌入式服务器（同JVM运行） #

如果必须启动完整嵌入式服务器，确保通过@LocalServerPort获取端口，RestAssured直接访问本地端口：

import io.restassured.RestAssured;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.server.LocalServerPort;

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class UserControllerTest {

    @LocalServerPort
    private int port;

    @BeforeEach
    void setUp() {
        RestAssured.port = port;
    }

    @Test
    void testGetUserById() {
        given()
            .param("id", 1)
        .when()
            .get("/api/users")
        .then()
            .statusCode(200);
    }
}

3. Jenkins流水线适配 #

直接在Jenkins流水线中执行标准Maven命令即可，无需额外配置：

pipeline {
    agent any
    stages {
        stage('Build & Test') {
            steps {
                sh 'mvn clean verify'
            }
        }
        stage('Publish JaCoCo Report') {
            steps {
                jacoco(
                    execPattern: '**/target/jacoco.exec',
                    classPattern: '**/target/classes',
                    sourcePattern: '**/src/main/java'
                )
            }
        }
    }
}

Jenkins的JaCoCo插件会自动读取生成的报告并展示覆盖率数据。

补充说明 #

Quarkus默认在测试进程内直接启动应用，天然同JVM，因此无需额外配置即可收集全量覆盖率；而Spring Boot默认若未明确禁止fork，可能导致应用与测试分属不同进程，这是两者的核心差异。

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