如何在独立运行WireMock时使用wiremock-faker-extension生成假桩数据

1. 准备扩展依赖包 #

因为你用的是WireMock独立运行版，需要额外下载两个核心jar包：

• wiremock-faker-extension：WireMock的faker扩展包
• java-faker：该扩展依赖的动态数据生成核心库

把这两个jar包和你的wiremock-standalone-3.3.1.jar放在同一个目录下（或者后续在启动命令里指定完整路径）。

2. 修改WireMock启动命令 #

原来的启动命令需要添加扩展加载参数，同时指定classpath包含扩展依赖。示例命令如下：

• Linux/macOS：

java -cp "wiremock-standalone-3.3.1.jar:wiremock-faker-extension-*.jar:javafaker-*.jar" com.github.tomakehurst.wiremock.standalone.WireMockServerRunner --port 9995 --verbose --global-response-templating --extensions com.wiremock.extensions.faker.FakerExtension

• Windows：

java -cp "wiremock-standalone-3.3.1.jar;wiremock-faker-extension-*.jar;javafaker-*.jar" com.github.tomakehurst.wiremock.standalone.WireMockServerRunner --port 9995 --verbose --global-response-templating --extensions com.wiremock.extensions.faker.FakerExtension

说明：

• -cp参数用来指定类路径，把所有需要的jar包包含进去
• --extensions指定加载faker扩展的全类名com.wiremock.extensions.faker.FakerExtension
• 保留你原来的--global-response-templating，这是模板生效的前提

3. 编写带faker模板的Stub #

在WireMock的stub定义中，用{{faker.xxx.yyy}}的语法调用faker生成动态数据。示例Stub（可放在WireMock的__files或mappings目录下）：

{
  "request": {
    "method": "GET",
    "url": "/api/random-user"
  },
  "response": {
    "status": 200,
    "body": "{\"user_id\": {{randomValue length=8 type='ALPHANUMERIC'}}, \"full_name\": \"{{faker.name.fullName}}\", \"work_email\": \"{{faker.internet.safeEmail}}\", \"home_address\": \"{{faker.address.streetAddress}}, {{faker.address.city}}\", \"phone\": \"{{faker.phoneNumber.phoneNumber}}\"}",
    "headers": {
      "Content-Type": "application/json; charset=utf-8"
    }
  }
}

常用的faker模板示例：

• 姓名：{{faker.name.fullName}}
• 邮箱：{{faker.internet.email}}
• 地址：{{faker.address.fullAddress}}
• 手机号：{{faker.phoneNumber.phoneNumber}}
• 随机数字：{{faker.number.numberBetween min=100 max=999}}

4. 验证效果 #

启动WireMock后，调用对应的接口（比如上面的GET /api/random-user），每次请求都会返回不同的动态生成数据，替代你之前的临时方案。

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