Spring Boot3升级后多测试类运行时WireMock出现RequestHandler空指针

这个问题的核心是共享的WireMockClassRule在多测试类运行时的生命周期冲突：Spring Boot 3升级后，JUnit 4的测试上下文管理逻辑发生变化，加上WireMock旧版本与Spring Boot 3的依赖兼容性问题，导致第一个测试类执行完毕后，静态WireMockClassRule对应的WireMock服务被销毁，但后续测试类仍尝试调用已停止的服务，从而抛出RequestHandler空指针，且管理端点返回500错误。

以下是针对性的解决方法：

方法一：每个测试类使用独立的WireMock实例 #

放弃共享静态ClassRule，改为每个测试类使用自己的WireMockRule，并用随机端口避免冲突：

@Rule
public WireMockRule wireMockRule = new WireMockRule(WireMockConfiguration.options().dynamicPort());

测试代码中通过wireMockRule.port()获取当前WireMock服务的端口，替代硬编码的8089。这种方式彻底隔离了不同测试类的WireMock实例，不会出现跨测试类的状态污染或服务已停止的问题。

方法二：重置WireMock状态并确保服务持续运行 #

如果必须共享WireMock实例，需在每个测试类执行前重置WireMock的状态，并确保服务不会被提前销毁：

1. 在每个测试类中添加重置逻辑：

@Before
public void resetWireMockState() {
    // 清除所有已定义的stub和请求日志
    WireMock.reset();
}

2. 检查WireMock版本是否适配Spring Boot 3：确保使用WireMock 3.x及以上版本，旧版本（如2.x）与Spring Boot 3依赖的Servlet API 6.0、Jetty 11等存在兼容性问题，会导致多测试类运行时服务异常。

方法三：迁移到JUnit 5 + WireMockExtension #

Spring Boot 3对JUnit 5的支持更完善，改用JUnit 5的WireMockExtension可以避免JUnit 4的生命周期冲突问题：

import com.github.tomakehurst.wiremock.junit5.WireMockExtension;
import static com.github.tomakehurst.wiremock.core.WireMockConfiguration.options;

@ExtendWith(WireMockExtension.class)
public class YourTestClass {
    @RegisterExtension
    static WireMockExtension wireMock = WireMockExtension.newInstance()
            .options(options().dynamicPort())
            .build();

    // 测试方法示例
    @Test
    public void testApiCall() {
        wireMock.stubFor(WireMock.get(WireMock.urlEqualTo("/test"))
                .willReturn(WireMock.aResponse().withStatus(200)));
        // 执行测试逻辑
    }
}

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