配置WireMock为同URL多测试返回不同状态码遇问题

问题根源 #

WireMock的存根（Stub）是全局累积的，当运行整个测试套件时，先执行的200场景存根不会自动清除。由于两个测试的请求匹配规则完全一致（相同URL路径、相同id查询参数），后续404场景的请求会优先匹配到之前注册的200存根，导致返回错误的状态码。

解决方案 #

核心思路是保证每个测试的独立性，在测试执行前后清理WireMock的存根，避免跨测试干扰。以下是两种可靠的处理方式：

1. 测试前重置WireMock #

在每个测试方法执行前，调用重置方法清除所有已注册的存根和请求日志：

• 若使用JUnit 5：

@BeforeEach
void setUp() {
    mockService.resetAll();
}

• 若使用JUnit 4：

@Before
public void setUp() {
    mockService.resetAll();
}

2. 替换同名存根（可选） #

给每个存根设置唯一名称，后续测试中用同名存根覆盖之前的配置：

// 200场景存根
mockService.stubFor(
    WireMock.get(WireMock.urlPathEqualTo(version + "/appointments"))
        .withQueryParam("id", WireMock.equalTo(id))
        .willReturn(WireMock.aResponse()
            .withStatus(HttpStatus.OK.value())
            .withHeader("Content-Type", MediaType.APPLICATION_JSON_VALUE)
            .withBody(copyToString(SomeObject))
        )
    .withName("appointment-detail-stub")
);

// 404场景存根，覆盖同名配置
mockService.stubFor(
    WireMock.get(WireMock.urlPathEqualTo(version + "/appointments"))
        .withQueryParam("id", WireMock.equalTo(id))
        .willReturn(WireMock.aResponse()
            .withStatus(HttpStatus.NOT_FOUND.value())
            .withHeader("Content-Type", MediaType.APPLICATION_JSON_VALUE)
        )
    .withName("appointment-detail-stub")
);

这种方式适合特定场景，但推荐优先使用重置方法，能彻底保证测试隔离。

额外优化建议 #

• 为每个测试生成唯一的id参数，进一步降低意外匹配的概率；
• 若使用WireMock官方JUnit扩展（@WireMockTest），可通过配置自动重置：

@WireMockTest(resetAfterEachTest = true)
public class AppointmentServiceTest {
    // 测试方法
}

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