Java案例怎么模拟接口请求？

wen java案例 2026-06-08 53

本文目录导读：

Java案例怎么模拟接口请求？

目录导读
为什么需要模拟接口请求？
主流模拟方案对比
案例一：基于Mockito的单元测试模拟
案例二：WireMock搭建本地模拟HTTP服务
案例三：使用OkHttp拦截器实现接口模拟（生产级技巧）
常见问题问答（Q&A）
不同场景下的最佳实践建议

目录导读

为什么需要模拟接口请求？——从实际开发痛点切入
主流模拟方案对比：Mockito、WireMock、Postman Mock Server
基于Mockito的单元测试模拟（附完整Java代码）
WireMock搭建本地模拟HTTP服务（含REST API示例）
使用OkHttp拦截器实现接口模拟（生产级技巧）
常见问题问答（Q&A）
不同场景下的最佳实践建议

为什么需要模拟接口请求？

在Java后端开发中,我们经常遇到以下场景：

第三方接口未准备好（如支付宝支付、短信网关）
依赖服务不稳定导致测试失败
并发压测时需要隔离真实调用
前端联调时后端接口尚未完成

这时,模拟接口请求（Mock） 就成为了提升开发效率和测试稳定性的关键技能，搜索引擎中常见的痛点包括：“Java怎么模拟HTTP请求？”“Mockito如何返回模拟数据？”“如何在不启动真实服务的情况下测试接口调用？”

主流模拟方案对比

方案	适用场景	优点	缺点
Mockito	单元测试（方法级别）	轻量化、无网络依赖	只能模拟对象行为，不模拟HTTP协议
WireMock	集成测试（HTTP协议级）	可录制真实请求、返回自定义响应	需要额外启动Mock服务进程
Postman Mock Server	前端联调	可视化配置，团队共享	依赖网络，不适合自动化测试

案例一：基于Mockito的单元测试模拟

场景：测试OrderService的pay()方法，它调用外部PaymentClient接口。

步骤：

引入依赖（Maven）：

<dependency>
 <groupId>org.mockito</groupId>
 <artifactId>mockito-core</artifactId>
 <version>4.11.0</version>
 <scope>test</scope>
</dependency>

编写单元测试：

@ExtendWith(MockitoExtension.class)
public class OrderServiceTest {
 @Mock
 private PaymentClient paymentClient;
 @InjectMocks
 private OrderService orderService;
 @Test
 void testPaySuccess() {
     // 模拟接口返回“支付成功”
     Mockito.when(paymentClient.charge(anyDouble()))
            .thenReturn("success");
     String result = orderService.pay(100.0);
     assertEquals("支付成功", result);
 }
}

关键点：when().thenReturn() 模拟了PaymentClient接口的返回值，无需真实网络请求。

案例二：WireMock搭建本地模拟HTTP服务

场景：模拟一个返回JSON数据的REST API，用于前端联调或集成测试。

步骤：

引入WireMock依赖（集成Spring Boot）：

<dependency>
 <groupId>com.github.tomakehurst</groupId>
 <artifactId>wiremock-jre8-standalone</artifactId>
 <version>2.35.0</version>
</dependency>

配置Mock服务（启动时动态添加）：

@SpringBootTest
@AutoConfigureMockMvc
@WireMockTest(httpPort = 8089)
public class MockServerTest {
 @Test
 void testGetUser() {
     // 模拟GET请求返回固定数据
     stubFor(get(urlEqualTo("/user/1"))
         .willReturn(aResponse()
             .withHeader("Content-Type", "application/json")
             .withBody("{\"name\":\"张三\",\"age\":25}")));
     // 调用真实服务，但URL指向Mock端口
     // 实际请求：http://localhost:8089/user/1
     String result = restTemplate.getForObject(
         "http://localhost:8089/user/1", String.class);
     assertTrue(result.contains("张三"));
 }
}

优势：WireMock可以设置延迟、异常、状态码，甚至从日志中验证请求次数，非常适合压测场景。

案例三：使用OkHttp拦截器实现接口模拟（生产级技巧）

场景：在开发环境中，无需修改代码即可全局替换真实接口调用为Mock数据。

实现方式：

创建自定义拦截器：

public class MockInterceptor implements Interceptor {
 @Override
 public Response intercept(Chain chain) throws IOException {
     String url = chain.request().url().toString();
     if (url.contains("/api/payment")) {
         // 直接返回模拟数据
         return new Response.Builder()
             .code(200)
             .message("OK")
             .body(ResponseBody.create(
                 MediaType.parse("application/json"),
                 "{\"status\":\"success\"}"))
             .request(chain.request())
             .protocol(Protocol.HTTP_1_1)
             .build();
     }
     return chain.proceed(chain.request());
 }
}

在OkHttpClient中注册：

OkHttpClient client = new OkHttpClient.Builder()
 .addInterceptor(new MockInterceptor())
 .build();

优势：无需启动额外服务，且能通过配置文件开关控制是否启用模拟，适合多环境切换。

常见问题问答（Q&A）

Q1：Mockito和WireMock能一起用吗？
A：可以，推荐在单元测试中用Mockito（速度快），集成测试中用WireMock（协议层验证）。

Q2：如何模拟接口返回超时或异常？
A：WireMock支持withFixedDelay(5000)模拟5秒延迟；Mockito支持thenThrow(new RuntimeException("服务异常"))。

Q3：我的接口需要鉴权Token，怎么模拟？
A：在WireMock中可以用withHeader("Authorization", "Bearer mock_token")来匹配请求头；Mockito则可以直接模拟含有鉴权逻辑的对象。

Q4：是否有现成的在线Mock服务？
A：有，如Postman Mock Server、JSONPlaceholder，但慎用，数据可能泄露，建议本地搭建。

不同场景下的最佳实践建议

开发联调阶段：推荐WireMock或Postman Mock Server，快速验证前后端接口协议。
单元测试阶段：优先Mockito，轻量、高效，不依赖外部服务。
生产环境隔离：使用OkHttp拦截器/Spring RestTemplate拦截器实现动态Mock开关。
压测与稳定性测试：WireMock结合延迟模拟，能有效验证熔断降级逻辑。

掌握这三种模拟方式,你就能应对90%以上的Java接口模拟需求。模拟不是造假，而是为了更可控地验证系统边界。 在真实项目中，请始终确保Mock数据与真实数据结构保持一致，并定期用契约测试（如Pact）来验证双方接口一致性。