能否在非Spring/Spring Boot项目中使用WebTestClient做API测试？

核心结论 #

仅依赖spring-test无法使用WebTestClient进行API测试，原因是：
WebTestClient是Spring WebFlux生态的HTTP测试客户端，spring-test包仅提供了该客户端的入口类，但核心实现（如请求处理、响应解析、Mono/Flux等反应式类型支持）完全依赖spring-webflux的底层类。你看到的报错就是因为缺少这些核心实现类。

可行方案 #

方案1：添加spring-webflux测试依赖（推荐） #

既然要使用WebTestClient，必须补充spring-webflux依赖，即使你的项目是非Spring/Spring Boot项目，仅在测试阶段引入即可：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webflux</artifactId>
    <version>5.3.31</version>
    <scope>test</scope>
</dependency>

添加后，你的现有测试代码可以直接运行，无需修改。

方案2：改用spring-test兼容的通用HTTP测试方式（无需额外依赖） #

如果坚持只使用spring-test，可以结合JDK原生HTTP客户端，再配合spring-test的断言工具实现需求。示例代码如下：

import org.junit.Test;
import org.springframework.test.util.AssertionErrors;

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

@Test
public void testData() throws IOException, InterruptedException {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://www.test.com/data/123"))
            .header("Content-Type", "text/plain")
            .header("Accept", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("testText"))
            .build();

    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    
    // 使用spring-test的断言工具验证结果
    AssertionErrors.assertEquals("响应状态码不正确", 200, response.statusCode());
}

这种方式完全基于JDK原生HTTP客户端和spring-test的断言类，无需额外引入Spring Web相关依赖。

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