基于JUnit环境使用WireMock模拟外部REST服务的测试方案问询

刚好最近也在用WireMock处理这类外部服务依赖的测试，用WireMockRule确实是个非常优雅的解决方案——完全不用单独折腾独立服务器，直接把它集成到JUnit测试里就行，给你一步步拆解怎么实现：

1. 先搞定依赖 #

首先需要在项目中引入WireMock的JUnit集成依赖，以Maven和Gradle为例：

Maven（pom.xml） #

<dependency>
    <groupId>com.github.tomakehurst</groupId>
    <artifactId>wiremock-junit4</artifactId>
    <version>2.35.0</version> <!-- 可以用最新稳定版 -->
    <scope>test</scope>
</dependency>

Gradle（build.gradle） #

testImplementation 'com.github.tomakehurst:wiremock-junit4:2.35.0'

2. 配置WireMockRule #

在你的JUnit测试类中，通过@Rule注解（JUnit 4）声明WireMockRule，它会自动在测试前后启动/停止WireMock服务，完全不需要手动操作：

import com.github.tomakehurst.wiremock.junit.WireMockRule;
import org.junit.Rule;

public class ExternalServiceIntegrationTest {

    // 可以指定固定端口，或者传0让WireMock随机分配端口（更灵活，避免端口冲突）
    @Rule
    public WireMockRule wireMockRule = new WireMockRule(8080);
}

如果用JUnit 5，可以换成WireMockExtension配合@ExtendWith注解，核心逻辑是一致的。

3. 让应用请求指向WireMock #

原来的应用调用的是http://otherserver.com，我们需要在测试环境把这个地址替换成WireMock的服务地址：

• 如果你的应用是通过配置项读取外部服务地址，直接在测试中把配置值改成wireMockRule.baseUrl()即可（比如http://localhost:8080）；
• 如果是硬编码的地址，建议改成可配置的形式（比如通过Spring的@Value、或者自定义配置类），这样测试时更容易替换，也更符合工程规范。

4. 编写Stub规则模拟目标请求 #

用WireMock的stubFor方法，精准模拟GET http://otherserver.com/service3/这个请求的响应逻辑：

import static com.github.tomakehurst.wiremock.client.WireMock.*;

@Test
public void testService3Invocation() {
    // 1. 定义Stub：匹配GET /service3/请求，返回模拟响应
    stubFor(get(urlEqualTo("/service3/"))
            .willReturn(aResponse()
                    .withStatus(200) // 设置响应状态码
                    .withHeader("Content-Type", "application/json") // 设置响应头
                    .withBody("{\"code\": 0, \"data\": \"mock service3 response\"}"))); // 设置响应体

    // 2. 替换应用的外部服务地址为WireMock地址
    YourAppConfig.setExternalServiceBaseUrl(wireMockRule.baseUrl());

    // 3. 调用应用中依赖外部服务的业务方法
    YourBusinessService service = new YourBusinessService();
    String response = service.callExternalService3();

    // 4. 验证逻辑：比如断言响应结果，或者验证WireMock是否收到了请求
    verify(getRequestedFor(urlEqualTo("/service3/"))); // 确认请求已触发
    // 这里可以加具体的业务断言，比如Assert.assertEquals("预期结果", response);
}

进阶：模拟复杂场景 #

如果需要匹配带查询参数、请求头的请求，或者模拟错误响应，WireMock也能轻松搞定：

匹配带查询参数的请求 #

// 匹配 GET /service3/?id=123&status=active 的请求
stubFor(get(urlPathEqualTo("/service3/"))
        .withQueryParam("id", equalTo("123"))
        .withQueryParam("status", equalTo("active"))
        .willReturn(aResponse().withStatus(200)));

模拟错误响应 #

// 模拟外部服务返回500错误
stubFor(get(urlEqualTo("/service3/"))
        .willReturn(aResponse()
                .withStatus(500)
                .withBody("Internal Server Error from mock service")));

这种方案完全不需要单独启动WireMock服务器，测试用例自包含，而且通过Stub规则可以精准模拟各种外部服务的行为，比手写模拟控制器灵活得多，也更符合测试的隔离性要求。

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