Spring Boot中JUnit 5测试失败时如何显示预期与实际值？

当然可以实现，以下是针对你的场景的具体调整方案：

1. 确保使用AssertJ的assertThat（而非JUnit原生断言） #

Spring Test默认集成的assertThat来自AssertJ库，它本身就会在断言失败时自动输出预期值与实际值的对比详情。比如你执行：

assertThat(responseEntity.getStatusCode()).isEqualTo(HttpStatus.CREATED);

如果实际返回500，AssertJ会直接在失败日志里输出：

expected: <CREATED(201)>
 but was: <INTERNAL_SERVER_ERROR(500)>

如果你的项目里没显式引入AssertJ（Spring Boot默认已包含），可以在build.gradle里补充依赖：

testImplementation 'org.assertj:assertj-core:3.24.2'

2. 优化Gradle的测试日志配置 #

你现有的testLogging只开启了基础事件记录，需要补充配置来显示完整的断言失败细节。修改配置如下：

tasks.named('test') {
    useJUnitPlatform()

    testLogging {
        events("passed", "skipped", "failed")
        // 显示断言失败的异常原因与栈跟踪
        showExceptions = true
        showCauses = true
        showStackTraces = true
        // 输出测试中打印的标准输出/错误流（比如手动打印的响应内容）
        showStandardStreams = true
        // 用完整格式展示异常信息
        exceptionFormat = 'full'
    }
}

这个配置会让控制台完整输出AssertJ生成的断言对比信息，包括预期值、实际值的具体内容。

3. 增强HTTP响应的断言可读性 #

给断言添加上下文描述 #

用as()方法给断言补充业务场景说明，失败时能快速定位问题环节：

assertThat(responseEntity.getStatusCode())
    .as("创建用户接口的响应状态码")
    .isEqualTo(HttpStatus.CREATED);

失败时会先显示你添加的描述，再输出值对比细节。

响应体的详细断言 #

对于文本响应体，直接用AssertJ的字符串断言，失败时会高亮显示差异部分：

String actualBody = responseEntity.getBody();
String expectedBody = "{\"id\":1,\"name\":\"test\"}";

assertThat(actualBody)
    .as("创建用户的响应体内容")
    .isEqualTo(expectedBody);

如果实际响应体和预期有差异，AssertJ会输出字符串的对比细节，标出不同的字符位置。

如果是JSON响应，还可以配合Spring Boot的JsonPath断言，更精准地验证字段：

import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;

// MockMvc场景示例
mockMvc.perform(post("/users"))
    .andExpect(jsonPath("$.id").value(1))
    .andExpect(jsonPath("$.name").value("test"));

这种方式失败时会直接提示哪个JSON字段不符合预期。

4. 测试失败时自动保存响应详情 #

针对大型流程测试，可实现JUnit 5的TestWatcher接口，在测试失败时自动记录完整响应信息：

import org.junit.jupiter.api.extension.ExtensionContext;
import org.junit.jupiter.api.extension.TestWatcher;
import java.util.Optional;

public class ResponseLoggingWatcher implements TestWatcher {
    private ResponseEntity<?> failedResponse;

    public void setFailedResponse(ResponseEntity<?> response) {
        this.failedResponse = response;
    }

    @Override
    public void testFailed(ExtensionContext context, Throwable cause) {
        if (failedResponse != null) {
            System.err.println("===== 测试失败响应详情 =====");
            System.err.println("状态码: " + failedResponse.getStatusCode());
            System.err.println("响应体: " + failedResponse.getBody());
            System.err.println("响应头: " + failedResponse.getHeaders());
            System.err.println("=========================");
        }
    }

    // 实现其他TestWatcher默认空方法
    @Override
    public void testSuccessful(ExtensionContext context) {}
    @Override
    public void testAborted(ExtensionContext context, Throwable cause) {}
    @Override
    public void testDisabled(ExtensionContext context, Optional<String> reason) {}
}

然后在测试类里注册扩展并传入响应对象：

@ExtendWith(ResponseLoggingWatcher.class)
class LargeFlowTest {
    @Autowired
    private ResponseLoggingWatcher loggingWatcher;

    @Test
    void testLargeFlow() {
        ResponseEntity<?> response = // 调用接口获取响应
        loggingWatcher.setFailedResponse(response);
        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.CREATED);
    }
}

内容的提问来源于stack exchange，提问作者e-info128