Spring Boot集成Wiremock启动失败：请求匹配操作无效

问题原因 #

你使用的Wiremock 2.27.2版本不支持在queryParameters的单个参数配置中直接使用or这类复合匹配器。该版本的参数匹配仅支持单一的匹配操作（如absent、matches、doesNotMatch），复合逻辑的匹配需要通过其他方式实现。

解决方案 #

1. 拆分Stub规则

将原有的复合逻辑拆分为两个独立的Stub，分别对应"latest参数不存在"和"latest参数格式错误"的场景，设置相同的优先级与响应内容即可达到等效效果：

匹配参数不存在的Stub：

{
  "priority": 1,
  "request": {
    "urlPath": "/someapi/searchTimeslot",
    "method": "GET",
    "queryParameters": {
      "latest": {
        "absent": true
      }
    }
  },
  "response": {
    "status": 422,
    "jsonBody": [{"code": 422, "detail": "Invalid Parameter Value", "field": "latest", "message": "An allowed parameter was assigned an invalid value"}],
    "headers": {
      "Content-Type": "application/json"
    }
  }
}

匹配参数格式错误的Stub：

{
  "priority": 1,
  "request": {
    "urlPath": "/someapi/searchTimeslot",
    "method": "GET",
    "queryParameters": {
      "latest": {
        "doesNotMatch": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"
      }
    }
  },
  "response": {
    "status": 422,
    "jsonBody": [{"code": 422, "detail": "Invalid Parameter Value", "field": "latest", "message": "An allowed parameter was assigned an invalid value"}],
    "headers": {
      "Content-Type": "application/json"
    }
  }
}

2. 升级Wiremock版本

Wiremock在2.30.0及以上版本中新增了参数匹配的复合逻辑支持，允许直接在queryParameters中使用or、and操作符。你可以升级依赖版本（注意兼容Spring Boot 2.7.x），修改pom.xml：

<dependency>
  <groupId>com.github.tomakehurst</groupId>
  <artifactId>wiremock-jre8</artifactId>
  <version>2.35.0</version> <!-- 或更高的稳定兼容版本 -->
</dependency>

升级完成后，你最初的配置即可正常生效。

3. 使用脚本式自定义请求匹配器

如果无法升级版本，可通过Wiremock的script类型请求匹配器实现复合逻辑：

{
  "priority": 1,
  "requestMatcher": {
    "name": "script",
    "parameters": {
      "script": "request.queryParameter('latest') == null || !request.queryParameter('latest').matches('^\\\\d{4}-\\\\d{2}-\\\\d{2}T\\\\d{2}:\\\\d{2}:\\\\d{2}Z$')"
    }
  },
  "request": {
    "urlPath": "/someapi/searchTimeslot",
    "method": "GET"
  },
  "response": {
    "status": 422,
    "jsonBody": [{"code": 422, "detail": "Invalid Parameter Value", "field": "latest", "message": "An allowed parameter was assigned an invalid value"}],
    "headers": {
      "Content-Type": "application/json"
    }
  }
}

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