Spring Boot集成测试：WebTestClient下HttpServletRequest注入失败问题

Hey，我之前在做Spring Boot集成测试的时候也碰到过类似的问题，刚好能给你一些实用的建议！

首先得搞清楚为什么会出现这个异常：你用的WebTestClient是为Reactive（WebFlux）场景设计的测试工具，而HttpServletRequest是Servlet（Spring MVC）栈里的核心对象。在Reactive测试环境下，默认不会自动维护Servlet上下文，所以哪怕你Mock了HttpServletRequest，也没法自动注入到@ControllerAdvice的@ExceptionHandler方法里——因为WebTestClient模拟的请求根本走的不是Servlet的处理流程，自然找不到合适的参数解析器。

接下来给你几个可行的解决方向：

1. 切换到MockMvc（最推荐，适配Servlet栈） #

如果你的项目是基于Spring MVC（Servlet栈）的，那MockMvc才是最适合的集成测试工具，它天生就能处理HttpServletRequest这类Servlet API对象的注入。

只需要调整你的测试类配置：

@SpringBootTest
@AutoConfigureMockMvc
public class YourTestClass {

    @Autowired
    private MockMvc mockMvc;

    @Test
    void test_fixed() throws Exception {
        // 用MockMvc构造请求，替代WebTestClient
        mockMvc.perform(get("/your-test-endpoint")
                        .header("X-Request-Id", "123"))
                .andExpect(status().isBadRequest())
                .andExpect(jsonPath("$.message").value("expected error"));
    }
}

这样一来，@ExceptionHandler里的HttpServletRequest就能正常被注入了，因为MockMvc会完整模拟Servlet请求的上下文。

2. 若必须用WebTestClient，适配Reactive环境 #

如果你的项目是混合栈（同时用了MVC和WebFlux），或者一定要用WebTestClient，那可以做以下调整：

方案A：改用Reactive请求对象

把@ExceptionHandler里的HttpServletRequest替换成Reactive栈的ServerHttpRequest，它是WebTestClient能识别的请求对象：

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(YourCustomException.class)
    public ResponseEntity<ErrorDto> handleException(ServerHttpRequest request, YourCustomException ex) {
        // 用ServerHttpRequest获取请求信息，比如路径、头信息
        String requestPath = request.getPath().value();
        ErrorDto error = new ErrorDto(ex.getMessage(), requestPath);
        return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);
    }
}

这种方式不需要额外配置，WebTestClient会自动注入ServerHttpRequest，完美适配Reactive测试场景。

方案B：手动绑定MockHttpServletRequest到测试上下文

如果一定要保留HttpServletRequest，可以在测试中手动构建Mock对象并绑定到请求上下文。你可以通过自定义WebTestClientConfigurer或者添加请求属性来实现：

@SpringBootTest
@AutoConfigureWebTestClient
public class YourTestClass {

    @Autowired
    private WebTestClient webTestClient;

    @Test
    void test_fixed_with_webclient() {
        MockHttpServletRequest mockRequest = new MockHttpServletRequest();
        mockRequest.setRequestURI("/your-test-endpoint");
        mockRequest.addHeader("X-User-Id", "456");

        webTestClient.get().uri("/your-test-endpoint")
                .header("Mock-Http-Servlet-Request", mockRequest)
                .exchange()
                .expectStatus().isBadRequest()
                .expectBody(ErrorDto.class);
    }
}

然后在@ControllerAdvice里，从请求头中取出这个Mock对象：

@ExceptionHandler(YourCustomException.class)
public ResponseEntity<ErrorDto> handleException(@RequestHeader("Mock-Http-Servlet-Request") MockHttpServletRequest request, YourCustomException ex) {
    // 使用mockRequest处理逻辑
}

不过这种方式比较繁琐，不如直接切换到Reactive对象或者MockMvc来得省心。

3. 检查测试类的注解配置 #

最后还要确认你的测试类注解是否正确：

• 如果用@WebFluxTest，它只会加载WebFlux相关的Bean，不会加载Servlet栈的配置，所以HttpServletRequest的解析器不会被注册，自然报错。这时候应该改用@SpringBootTest配合@AutoConfigureWebTestClient，确保Servlet相关的自动配置被加载。
• 确保你的@ControllerAdvice类在测试上下文里被正确扫描到，比如没有被@MockBean或者@ExcludeFilter排除掉。

按照上面的方法调整，应该就能解决这个注入异常了！

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