如何在MockWebServer中正确使用@BeforeEach和@AfterEach注解？

核心问题拆解 #

1. 使用@BeforeEach/@AfterEach时触发java.lang.IllegalArgumentException: [TEST//operation-a/v1] is not a valid HTTP URL：本质是MockWebServer的URL拼接错误，手动硬拼前缀或路径时未遵循HTTP URL规范，且未正确获取服务器实际运行的baseUrl。
2. 使用@BeforeAll/@AfterAll时测试结果随机、不稳定：多个测试用例共享同一MockWebServer实例，请求队列、响应配置未重置，导致测试间产生脏数据交叉干扰。

稳定实现方案 #

方案1：每个测试用例独立实例化MockWebServer（彻底隔离+解决URL错误） #

通过@BeforeEach/@AfterEach为每个测试创建全新的MockWebServer实例，关键是用服务器自带方法生成合法URL，避免手动拼接错误。

示例代码：

import okhttp3.mockwebserver.MockWebServer;
import okhttp3.mockwebserver.MockResponse;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.web.reactive.function.client.WebClient;

public class OperationControllerTest {
    private MockWebServer mockServer;
    private WebClient webClient;

    @BeforeEach
    void initServer() throws Exception {
        mockServer = new MockWebServer();
        mockServer.start();
        // 自动生成合法的baseUrl，格式为http://localhost:端口/
        String validBaseUrl = mockServer.url("/").toString();
        // 配置客户端指向MockWebServer
        webClient = WebClient.builder().baseUrl(validBaseUrl).build();
    }

    @AfterEach
    void shutdownServer() throws Exception {
        mockServer.shutdown();
    }

    @Test
    void testOperationA() {
        // 配置Mock响应
        mockServer.enqueue(new MockResponse()
                .setBody("{\"code\":200,\"msg\":\"success\"}")
                .setResponseCode(200));

        // 发起请求并断言
        String response = webClient.get()
                .uri("/operation-a/v1")
                .retrieve()
                .bodyToMono(String.class)
                .block();

        assert response.contains("success");
    }
}

方案2：共享实例+测试前重置状态（优化性能+保证隔离） #

如果每个测试都创建销毁服务器影响速度，可通过@TestInstance(PER_CLASS)共享实例，但必须在每个测试前重置服务器状态，清除残留的请求和响应配置。

示例代码：

import okhttp3.mockwebserver.MockWebServer;
import okhttp3.mockwebserver.MockResponse;
import org.junit.jupiter.api.AfterAll;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.TestInstance;
import org.springframework.web.reactive.function.client.WebClient;

@TestInstance(TestInstance.Lifecycle.PER_CLASS)
public class OperationControllerTest {
    private MockWebServer mockServer;
    private WebClient webClient;

    @BeforeAll
    void initServerOnce() throws Exception {
        mockServer = new MockWebServer();
        mockServer.start();
        String validBaseUrl = mockServer.url("/").toString();
        webClient = WebClient.builder().baseUrl(validBaseUrl).build();
    }

    @BeforeEach
    void resetServerState() {
        // 清空所有未处理请求和已配置的响应，保证测试独立
        mockServer.reset();
    }

    @AfterAll
    void shutdownServerOnce() throws Exception {
        mockServer.shutdown();
    }

    @Test
    void testOperationA() {
        mockServer.enqueue(new MockResponse().setBody("success").setResponseCode(200));
        // 测试逻辑...
    }

    @Test
    void testOperationB() {
        mockServer.enqueue(new MockResponse().setBody("failed").setResponseCode(400));
        // 测试逻辑...
    }
}

坑点规避 #

• 禁止手动拼接URL：始终使用mockWebServer.url(path)生成完整合法的URL，避免出现非法格式。
• 测试隔离优先：无论用哪种方案，必须保证每个测试用例的Mock状态独立，要么新建实例，要么重置状态。
• 处理异步逻辑：若测试包含异步调用，需确保等待响应完成后再执行断言，避免因异步未结束导致的不稳定结果。

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