异步调用切换线程后WireMock Stub Mappings消失问题求助

使用Kotlin + Micronaut编写集成测试时，存在一个端点执行逻辑后调用异步函数并返回202，异步函数定义如下：

@Async
open fun asynFunction(): CompletableFuture<Void>

同步调用场景下，WireMock工作正常，Stub Mappings注册成功且测试通过；但切换为异步调用后，Stub映射消失。调用GET localhost:3000/__admin/mappings返回空映射：

{
    "mappings": [],
    "meta": {
        "total": 0
    }
}

同时收到报错：No response could be served as there are no stub mappings in this WireMock instance.

当前WireMock Server启动代码：

companion object {
    val wireMockServer = WireMockServer(3000)

    init {
        wireMockServer.start()
    }
}

原因分析 #

• WireMock线程上下文绑定限制：默认情况下，WireMock的Stub Mappings是与当前线程上下文绑定的。异步代码切换到新线程执行时，新线程无法访问主线程中注册的Stub配置，导致映射“消失”。
• 静态初始化的上下文不一致：仅通过companion object的init块启动WireMock，若测试框架的线程模型与异步线程不共享同一上下文，会导致异步线程无法识别主线程注册的Stub。

解决方法 #

1. 绑定Stub到WireMockServer实例而非线程 #

注册Stub时，直接使用启动的wireMockServer实例调用stubFor，而非依赖静态WireMock类（静态类默认绑定当前线程）：

// 正确写法：用实例注册Stub
wireMockServer.stubFor(get(urlEqualTo("/your-target-endpoint"))
    .willReturn(aResponse().withStatus(200)))

2. 统一管理WireMock生命周期 #

结合测试框架的生命周期注解（如JUnit 5的@BeforeAll/@AfterAll）启动、停止WireMock，并在初始化阶段统一注册Stub，确保所有线程关联同一实例：

companion object {
    lateinit var wireMockServer: WireMockServer

    @BeforeAll
    @JvmStatic
    fun setup() {
        wireMockServer = WireMockServer(3000)
        wireMockServer.start()
        // 在这里注册所有测试需要的Stub
        wireMockServer.stubFor(get(urlEqualTo("/async-test")).willReturn(aResponse().withStatus(200)))
    }

    @AfterAll
    @JvmStatic
    fun teardown() {
        wireMockServer.stop()
    }
}

3. 关闭WireMock线程隔离模式 #

启动WireMockServer时，配置全局Stub存储，让所有线程共享同一映射库：

val wireMockServer = WireMockServer(options()
    .port(3000)
    .stubMappingStorage(InMemoryStubMappingStorage())) // 使用全局内存存储

该配置会让Stub Mappings不再绑定线程，所有线程均可访问。

内容的提问来源于stack exchange，提问作者Paweł Sosnowski