HoRain云--解决WebTestClient访问接口报告[185c31bb] 500 Server Error的问题-CSDN博客

本文链接：https://blog.csdn.net/2401_86544677/article/details/147084006

🎬 HoRain云小助手：个人主页

⛺️生活的理想，就是为了理想的生活!

⛳️ 推荐

前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。

专栏介绍

专栏名称	专栏介绍
《C语言》	本专栏主要撰写C干货内容和编程技巧，让大家从底层了解C，把更多的知识由抽象到简单通俗易懂。
《网络协议》	本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘，一起解密网络协议在运行中协议的基本运行机制！
《docker容器精解篇》	全面深入解析 docker 容器，从基础到进阶，涵盖原理、操作、实践案例，助您精通 docker。
《linux系列》	本专栏主要撰写Linux干货内容，从基础到进阶，知识由抽象到简单通俗易懂，帮你从新手小白到扫地僧。
《python 系列》	本专栏着重撰写Python相关的干货内容与编程技巧，助力大家从底层去认识Python，将更多复杂的知识由抽象转化为简单易懂的内容。
《试题库》	本专栏主要是发布一些考试和练习题库（涵盖软考、HCIE、HRCE、CCNA等）

场景：控制器返回未处理的 Mono.error

修复方案：添加全局异常处理

测试代码验证：

五、总结步骤

一、快速定位问题

1. 查看详细错误日志

关键步骤：根据日志ID [185c31bb] 找到完整的异常堆栈信息。
操作方式：
- 在日志文件中搜索 185c31bb，定位到具体的错误位置。
- 关注 Caused by: 后的根本原因（如 NullPointerException、DatabaseConnectionException 等）。

2. 启用DEBUG日志

Spring Boot配置：在 application.properties 或 application-test.properties 中增加：

logging.level.root=DEBUG
logging.level.org.springframework.web=DEBUG
logging.level.your.package=TRACE

目的：获取更详细的请求处理流程和异常信息。

二、常见原因及解决方案

1. 代码逻辑错误

典型问题：
- 控制器（@RestController）中未处理的异常。
- 服务层返回 null 或未校验数据合法性。
排查方法：
- 检查控制器方法是否添加了 @ExceptionHandler 或全局异常处理（@ControllerAdvice）。
- 在测试中打印响应体，确认错误信息：
```
webTestClient.get().uri("/api/endpoint")
    .exchange()
    .expectStatus().isOk()
    .expectBody(String.class).consumeWith(System.out::println);
```

2. 依赖组件未正确注入

典型问题：
- 测试环境未正确初始化Bean（如数据库连接、缓存、第三方服务）。
- 使用 @MockBean 但未定义Mock行为。

解决方案：

确保测试类添加了 @SpringBootTest 或 @WebFluxTest 注解。

如果使用Mock，需明确指定Mock行为：

@MockBean
private UserService userService;

@BeforeEach
void setup() {
    Mockito.when(userService.findById(any())).thenReturn(Mono.just(new User()));
}

3. 数据库或外部服务问题

典型问题：
- 数据库迁移脚本未执行（如Liquibase/Flyway）。
- 测试数据库表结构或测试数据不匹配。

操作步骤：

检查测试数据库是否已应用最新的迁移脚本。

在测试前初始化数据：

@Test
void testEndpoint() {
    // 初始化测试数据
    databaseClient.insert().into(User.class).using(new User("test")).then().block();
    // 执行测试
    webTestClient.get().uri("/api/users/test")
        .exchange()
        .expectStatus().isOk();
}

4. 请求/响应序列化问题

典型问题：
- 请求体（@RequestBody）或路径变量类型不匹配。
- 响应体包含无法序列化的对象（如循环引用）。

排查方法：

检查接口定义的参数类型是否与请求匹配。

在测试中明确指定请求内容类型：

webTestClient.post().uri("/api/create")
    .contentType(MediaType.APPLICATION_JSON)
    .bodyValue("{ \"name\": \"test\" }")
    .exchange()
    .expectStatus().isOk();