Spring Boot响应式Web控制器测试报错，请求排查解决

核心原因 #

报错本质是Spring测试上下文无法自动检测到Spring Boot主配置类（带@SpringBootApplication的启动类），常见诱因有两个：

• 测试类所在包与主启动类的包结构不匹配（比如主类在com.example.demo4，但测试类实际在com.example.demo2）
• 测试代码存在冗余注解干扰上下文加载

具体修复步骤 #

1. 清理冗余注解 #

代码中导入了@SpringBootTest但未使用，直接删除该导入，避免混淆测试上下文：

// 删除此行
import org.springframework.boot.test.context.SpringBootTest;

2. 对齐包结构 #

检查主启动类（如Demo4Application）所在包，确保测试类UserControllerTest的包是主类包的子包或同一层级。
错误日志显示测试类实际在com.example.demo2.controller，但代码中声明的是com.example.demo4.controller，需将测试类的包路径调整为与主启动类一致的demo4下。

3. 显式指定主配置类（可选） #

若无法调整包结构，可在@WebFluxTest中通过classes属性直接指定主启动类：

@RunWith(SpringRunner.class)
@WebFluxTest(controllers = UserController.class, classes = Demo4Application.class)
public class UserControllerTest {
    // 原有代码不变
}

注意替换Demo4Application为你实际的主启动类名称。

4. 验证依赖完整性 #

确保项目依赖中包含WebFlux测试所需的依赖：
Maven示例：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
    <exclusions>
        <exclusion>
            <groupId>org.junit.vintage</groupId>
            <artifactId>junit-vintage-engine</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Gradle示例：

testImplementation 'org.springframework.boot:spring-boot-starter-test'
testImplementation 'io.projectreactor:reactor-test'
testRuntimeOnly 'org.junit.platform:junit-platform-launcher'

修复后的完整测试代码 #

package com.example.demo4.controller;

import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.reactive.WebFluxTest;
import org.springframework.test.context.junit4.SpringRunner;
import org.springframework.test.web.reactive.server.WebTestClient;

@RunWith(SpringRunner.class)
@WebFluxTest(UserController.class)
public class UserControllerTest {

    @Autowired
    private WebTestClient webTestClient;

    @Test
    public void getAllUsers() {
        webTestClient.get().uri("/api/users").exchange()
                .expectStatus().isOk();
    }
}

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