java 单元测试中,使用服务虚拟化模拟依赖的核心做法是引入 wiremock 等工具,在测试类启动时通过 @wiremocktest 注解或手动配置 wiremockserver 来拦截 http 请求。开发者只需定义期望的请求路径、方法以及对应的 json 响应数据,框架就会在内存中启动一个虚拟服务器接管这些流量,从而让被测代码在不连接真实外部服务的条件下完成逻辑验证。

如何配置本地虚拟服务器并注入到被测组件
配置过程主要依赖于 Spring Boot 的自动装配机制或标准的 Java 初始化流程。对于 Spring 项目,直接添加 wiremock-spring-boot 依赖并在测试类上标注 @WireMockTest 即可;该注解会自动创建一个运行在随机端口(默认 8089)的 WireMockServer 实例,并将其注入到被测试的 Bean 中。开发者需要确保被测组件中的客户端(如 RestTemplate 或 WebClient)配置的 Base URL 指向这个虚拟服务器的地址,通常可以通过 ${wiremock.server.url} 占位符动态获取。

import com.github.tomakehurst.wiremock.junit5.WireMockTest;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
@SpringBootTest
@WireMockTest
public class OrderServiceTest {
@Autowired
private OrderService orderService;
// 此时 wiremock.server.url 已自动配置为虚拟服务器地址
// 被测组件内部会向该地址发起请求
}
在非 Spring 环境下,需手动实例化 WireMockServer 并调用 start() 方法,随后将生成的 URL 传递给业务对象。这种注入方式确保了测试运行时网络请求被重定向至内存中的虚拟节点,避免了对外部网络的依赖。
如何定义具体的请求匹配规则与响应数据
定义匹配规则是使用服务虚拟化的关键步骤,它决定了虚拟服务器在接收到何种请求时返回预设数据。开发者利用 stubFor 方法构建期望,指定 HTTP 方法(如 GET、POST)、URL 路径以及可选的查询参数或 Header。例如,当被测代码请求 /api/products/123 时,可以配置虚拟服务器返回状态码 200 及包含产品信息的 JSON 体。若需模拟异常场景,可设置特定的状态码(如 500)或延迟响应,以验证系统的容错能力。

import static com.github.tomakehurst.wiremock.client.WireMock.*;
// 在测试方法内部配置存根
stubFor(get(urlEqualTo("/api/products/123"))
.willReturn(aResponse()
.withStatus(200)
.withHeader("Content-Type", "application/json")
.withBody("{\"id\": 123, \"name\": \"Widget\"}")));
// 执行被测逻辑
Product product = productService.getProductById(123);
assertThat(product.getName()).isEqualTo("Widget");
上述代码展示了如何精确匹配一个 GET 请求并返回固定 JSON。如果请求路径中包含可变部分,可以使用 urlPathMatching 配合正则表达式进行更灵活的匹配。所有定义的存根在测试结束后会自动清理,保证每次测试环境的纯净性。
基于程序中某个输入、条件或结果的具体问题
在实际开发中,经常遇到需要验证被测代码对特定 HTTP 状态码的处理逻辑,例如当依赖服务返回 404 时,系统是否正确地抛出了自定义异常或返回了默认值。针对这一具体条件,可以在测试中配置虚拟服务器针对同一 URL 返回不同的状态码,观察被测方法的返回值变化。这种基于输入条件的验证方式能够覆盖正常流和异常流,确保代码在面对外部服务不稳定时的健壮性。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











