java 单元测试中验证网络通信的核心做法是拦截 http 请求并返回预设响应,最稳定且常用的方案是使用 wiremock 或 mockwebserver。通过配置本地 mock 服务器,测试代码可以指定特定的 url、http 状态码和 json 响应体,从而在不依赖真实外部服务的情况下验证业务逻辑。这样做不仅能确保测试的确定性(deterministic),还能大幅加快执行速度并避免网络波动带来的干扰。

如何模拟特定 HTTP 状态码与响应内容
要模拟特定的 HTTP 状态码(如 404 或 500)及对应的响应内容,需使用 WireMock 的 stubFor 方法定义规则。在测试类中启动 WireMock 服务后,调用 WireMock.get(urlPathEqualTo("/api/data")) 匹配请求路径,并使用 willReturn(aResponse().withStatus(200).withBody("...")) 设定返回值。当被测代码发起请求时,WireMock 会拦截该请求并立即返回配置的响应,无需实际发送网络包到公网。

import com.github.tomakehurst.wiremock.junit5.WireMockTest;
import static com.github.tomakehurst.wiremock.client.WireMock.*;
@WireMockTest(root = "http://localhost:8089")
class NetworkTest {
@Test
void testSuccessResponse() {
stubFor(get(urlPathEqualTo("/users/1"))
.willReturn(aResponse()
.withStatus(200)
.withHeader("Content-Type", "application/json")
.withBody("{\"id\":1,\"name\":\"Alice\"}")));
// 假设这是你的业务代码
String result = httpClient.fetchUser(1);
assertEquals("Alice", result);
}
}
如何验证请求参数与 Header 是否匹配
若需验证客户端是否正确发送了请求头或查询参数,应在 WireMock 的 stubFor 链中添加 withHeader 或 withQueryParam 约束。例如,使用 .withHeader("Authorization", equalTo("Bearer token")) 来强制要求请求必须携带正确的 Token。如果实际请求不满足这些条件,WireMock 将不会匹配该存根,测试将因未找到预期响应而失败,从而确认通信细节符合预期。

@Test
void testAuthHeaderValidation() {
stubFor(get(urlPathEqualTo("/secure"))
.withHeader("Authorization", equalTo("Bearer valid-token"))
.willReturn(aResponse().withStatus(200)));
// 正确请求
httpClient.getSecure();
verify(getRequestedFor(urlPathEqualTo("/secure"))
.withHeader("Authorization", equalTo("Bearer valid-token")));
// 错误请求应触发异常或不同行为
assertThrows(HttpClientException.class, () -> httpClient.getWithBadToken());
}
如何处理超时与连接拒绝等异常情况
在测试网络健壮性时,需要模拟服务端无响应或主动断开连接的场景。对于超时,可以在 WireMock 中配置 fixedDelay 设置较长的延迟,或在测试代码中设置较短的 timeout 值来触发超时异常。对于连接拒绝,可以直接停止 WireMock 服务或使用防火墙规则阻止端口访问,验证代码是否能正确处理 ConnectException 或 SocketTimeoutException,确保程序在网络故障时具备容错能力。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











