Spring Boot中WebTestClient始终为null的问题求助

我之前也碰到过一模一样的坑！咱们一步步来排查和解决这个问题：

1. 先确认依赖是否正确 #

首先要确保你的项目里已经包含了WebTestClient所需的依赖。如果用Maven，spring-boot-starter-test已经默认包含了相关类，不需要额外引入，但要检查你的pom.xml有没有意外排除掉测试相关的依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
</dependency>

Gradle的话对应：

testImplementation 'org.springframework.boot:spring-boot-starter-test'

2. 使用自动配置的正确姿势 #

最省心的方式是让Spring帮你自动配置WebTestClient，只要在测试类上加上@AutoConfigureWebTestClient注解，配合@SpringBootTest使用：

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

    @Autowired
    private WebTestClient testClient;

    @Test
    void testGetUser() {
        testClient.get().uri("/users/1")
                  .exchange()
                  .expectStatus().isOk();
    }
}

这里webEnvironment = RANDOM_PORT会启动真实的嵌入式服务器，适合集成测试；如果想做Mock测试（不启动真实服务器），可以把webEnvironment设为MOCK，同样能自动注入WebTestClient。

3. 手动构建的正确方式 #

如果你一定要手动构建，要根据测试场景选对方法：

• 测试本地Mock环境：如果用@SpringBootTest配合@AutoConfigureMockMvc，应该绑定到MockMvc而不是直接连服务器：

@SpringBootTest
@AutoConfigureMockMvc
class MockMvcWebTestClientTest {

    @Autowired
    private MockMvc mockMvc;

    private WebTestClient testClient;

    @BeforeEach
    void setUp() {
        testClient = WebTestClient.bindToMockMvc(mockMvc).build();
    }

    // 测试方法...
}

• 绑定到ApplicationContext：如果想基于应用上下文构建，要确保上下文已经完全初始化：

@SpringBootTest
class AppContextWebTestClientTest {

    @Autowired
    private ApplicationContext applicationContext;

    private WebTestClient testClient;

    @BeforeEach
    void setUp() {
        testClient = WebTestClient.bindToApplicationContext(applicationContext).build();
    }

    // 测试方法...
}

你之前用的bindToServer()是用来测试远程已启动的服务器的，这时候需要确保你的Spring Boot应用已经在http://localhost:8080运行，否则自然连不上，测试时一般不会这么用。

4. 排查其他可能的问题 #

• 检查测试类的包路径：确保测试类和你的主应用类（带@SpringBootApplication的类）在同一个根包或子包下，否则Spring组件扫描可能扫不到配置类，导致WebTestClient无法被创建。
• 检查自定义配置：如果你有自定义的WebMvcConfigurer或WebFluxConfigurer，看看有没有覆盖了默认的WebTestClient配置，可以暂时注释掉自定义配置，测试是否恢复正常。

如果以上方法都试过还是不行，建议贴出你的测试类完整代码和依赖配置，这样更容易定位问题！

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