Spring Boot结合Kotlin时Mock HTTP服务器的最佳实现方式

2020年资料里提到的WireMock、MockWebServer等方案目前依然在持续维护，没有过时，不过近年针对Spring Boot 3.x、Kotlin协程生态出现了不少集成度更高、写法更简洁的选项，你可以根据自己项目的技术栈选择：

通用稳定方案（全场景适配，无额外学习成本） #

• Spring 官方集成的WireMock：属于Spring Cloud Contract组件的一部分，已经完成Spring Boot 3.x全版本适配，支持自动分配随机可用端口、测试后自动重置Stub、和Spring测试上下文缓存深度兼容，不需要手动处理端口占用、Stub串扰的问题，是目前Spring生态下最稳妥的选择。基础用法示例：

@SpringBootTest
@AutoConfigureWireMock(port = 0) // 传入0表示自动选择空闲端口
class UserHttpRepositoryTest {
    @Autowired
    private lateinit var userRepository: UserHttpRepository

    @Test
    fun `should fetch user info successfully`() {
        // 配置Mock响应规则
        stubFor(
            get(urlPathEqualTo("/api/users/1"))
                .willReturn(okJson("""{"id":1,"username":"testUser"}"""))
        )

        val user = userRepository.getById(1)
        assertEquals("testUser", user.username)
    }
}

• OkHttp MockWebServer：轻量无冗余依赖，如果你的项目HTTP客户端用的是OkHttp、Retrofit，选这个方案启动速度极快，支持模拟弱网、响应超时、HTTPS场景，原生支持Kotlin协程测试。

Kotlin专属友好方案 #

• MockK 客户端层Mock：不需要启动真实的HTTP监听服务，直接Mock项目中使用的HTTP客户端实例（WebClient、RestTemplate、OkHttpClient等），写法完全贴合Kotlin语法，测试执行速度最快，适合不需要验证HTTP请求报文格式、只验证业务逻辑的场景：

class UserHttpRepositoryTest {
    private val mockWebClient = mockk<WebClient>()
    private val userRepository = UserHttpRepository(mockWebClient)

    @Test
    fun `should fetch user info successfully`() {
        every {
            mockWebClient.get()
                .uri("/api/users/1")
                .retrieve()
                .bodyToMono(User::class.java)
                .block()
        } returns User(id = 1, username = "testUser")

        val user = userRepository.getById(1)
        assertEquals("testUser", user.username)
    }
}

• Ktor 官方Mock引擎：如果你的项目用Ktor作为HTTP客户端/服务端框架，优先选官方提供的内存Mock引擎，不需要占用网络端口，原生支持协程测试，DSL为Kotlin专属设计，不需要额外适配：

@Test
fun `should fetch user info successfully`() = runTest {
    val mockEngine = MockEngine { request ->
        respond(
            content = """{"id":1,"username":"testUser"}""",
            status = HttpStatusCode.OK,
            headers = headersOf(HttpHeaders.ContentType, "application/json")
        )
    }
    val httpClient = HttpClient(mockEngine)
    val userRepository = UserHttpRepository(httpClient)
    // 执行测试断言
}

选型建议：如果你的测试需要校验HTTP请求头、请求参数格式、超时等网络层逻辑，选启动真实端口的WireMock/MockWebServer方案；如果只需要验证上层Repository的业务逻辑，选MockK或者Ktor内存Mock的方案速度更快。

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