如何为不同测试方法加载独立的 WireMock JSON 映射文件

雨磊君_7075

雨磊君_7075

2026-11-21

330人浏览

原创

如何为不同测试方法加载独立的 WireMock JSON 映射文件

本文介绍在 Spring Boot 3.1+ 项目中,使用 spring-cloud-contract-wiremock 时,如何为每个 @Test 方法动态加载专属的 WireMock JSON stub 文件(如 test1.json、test2.json),避免全局映射冲突,提升测试隔离性与可维护性。

本文介绍在 spring boot 3.1+ 项目中,使用 `spring-cloud-contract-wiremock` 时,如何为每个 `@test` 方法动态加载专属的 wiremock json stub 文件(如 `test1.json`、`test2.json`),避免全局映射冲突,提升测试隔离性与可维护性。

默认情况下,@AutoConfigureWireMock(port = 0) 会自动扫描 src/test/resources/mappings/ 下所有 JSON 文件并一次性加载全部 stub,无法按需启用。若需实现「一测一映射」,推荐手动管理 WireMockServer 实例——绕过自动配置,显式创建、配置并销毁服务,从而精准控制每条测试所加载的 JSON 文件。

✅ 正确实践:按需加载指定 JSON 映射文件

首先,在 src/test/resources 下创建结构化目录(例如 mappings/SomeTest/),并放入对应 JSON 文件:

src/test/resources/mappings/SomeTest/
├── test1.json   # 返回 200
└── test2.json   # 返回 401

示例 test1.json:

从网页中提取schema.org、Open Graph和JSON-LD元数据以用于索引
从网页中提取schema.org、Open Graph和JSON-LD元数据以用于索引

使用 extruct 从原始 HTML 中提取机器可读的元数据,以便代理可以在不依赖脆弱的全页解析的情况下对页面进行分类、去重或丰富。它最适合元数据采集工作流,而不适用于爬取整个网站或渲染 JavaScript 密集型页面。

下载
{
  "request": {
    "method": "GET",
    "urlPath": "/endpoint"
  },
  "response": {
    "status": 200,
    "body": "{\"message\":\"OK\"}",
    "headers": {
      "Content-Type": "application/json"
    }
  }
}

然后在测试类中手动管理 WireMockServer:

import com.github.tomakehurst.wiremock.WireMockServer;
import com.github.tomakehurst.wiremock.common.FileSource;
import com.github.tomakehurst.wiremock.core.WireMockConfiguration;
import com.github.tomakehurst.wiremock.stubbing.StubMapping;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.core.io.ClassPathResource;
import org.springframework.util.StreamUtils;

import java.nio.charset.StandardCharsets;

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

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.NONE)
class SomeTest {

    private WireMockServer wireMockServer;

    @BeforeEach
    void setUp() {
        // 使用随机可用端口(兼容多模块并发测试)
        wireMockServer = new WireMockServer(WireMockConfiguration.options().dynamicPort());
        wireMockServer.start();
        configureFor("localhost", wireMockServer.port()); // 设置客户端目标地址
    }

    @AfterEach
    void tearDown() {
        if (wireMockServer != null) {
            wireMockServer.resetAll(); // 清除当前 stub
            wireMockServer.stop();     // 关闭实例
        }
    }

    @Test
    void test1() throws Exception {
        wireMockServer.addStubMapping(buildStubMapping("mappings/SomeTest/test1.json"));
        // 执行业务调用与断言
        // assertThat(httpClient.get("/endpoint")).hasStatusCode(200);
    }

    @Test
    void test2() throws Exception {
        wireMockServer.addStubMapping(buildStubMapping("mappings/SomeTest/test2.json"));
        // assertThat(httpClient.get("/endpoint")).hasStatusCode(401);
    }

    private StubMapping buildStubMapping(String path) throws Exception {
        ClassPathResource resource = new ClassPathResource(path);
        String json = StreamUtils.copyToString(resource.getInputStream(), StandardCharsets.UTF_8);
        return StubMapping.buildFrom(json);
    }
}

⚠️ 注意事项

  • 禁用自动配置:必须移除 @AutoConfigureWireMock,否则会与手动创建的 WireMockServer 冲突(端口占用或重复 stub);
  • 路径匹配:JSON 文件路径基于 src/test/resources,推荐使用子目录(如 mappings/SomeTest/)避免命名冲突;
  • 依赖版本适配:spring-cloud-contract-wiremock:4.0.2 基于 WireMock 1.3+,StubMapping.buildFrom() 可直接解析标准 WireMock JSON 格式;
  • 资源清理:务必在 @AfterEach 中调用 resetAll() 和 stop(),防止测试间状态污染;
  • 线程安全:每个测试方法独占一个 WireMockServer 实例(或至少独占其 stub 空间),天然支持并行执行。

✅ 总结

通过手动初始化 WireMockServer 并结合 addStubMapping(StubMapping) + ClassPathResource 加载 JSON,即可实现粒度至单个测试方法的 stub 隔离。该方式不依赖 Spring Boot 自动配置,更灵活、可控,特别适合契约测试中需要精确模拟多种 HTTP 状态、响应体或 Header 的场景。同时,JSON 映射文件可复用、可版本化、便于团队协作维护。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js json

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

13077

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

10142

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

8592

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1364

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1088

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1636

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3429

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20631

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1475

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.5万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习