使用Wiremock JSON Stub文件模拟查询参数失败问题排查

我之前也碰到过一模一样的问题，折腾了好一会儿才搞清楚根源，给你梳理下几个最可能的原因和对应的解决办法：

• JSON语法存在隐性错误
  你贴出来的第二个配置里，注意看urlPath: "/posts"后面的逗号——如果这是request对象里的倒数第二个字段，那这个逗号会导致JSON解析失败，Wiremock根本加载不了这个stub，自然就不会生效。建议用编辑器自带的JSON校验功能或者在线校验工具检查整个stub文件的语法，确保没有多余的逗号、缺失的括号这类问题。

• Wiremock版本过低
  早期的Wiremock版本（比如2.0之前的旧版本）对queryParameters字段的支持不完善，甚至有些版本根本不支持这个专用配置字段，只能用url字段做精确匹配。建议你升级到最新的稳定版（比如3.x系列），新版本对查询参数匹配的支持更稳定。

• 存在冲突的Stub优先级问题
  如果你之前那个用url: "/posts?id=1"的Stub还在Wiremock的配置里，那Wiremock会优先匹配精确的完整URL路径，而不会走到你用urlPath+queryParameters配置的Stub。解决办法是暂时移除旧的精确匹配Stub，再测试新配置是否生效。

• 启动参数禁用了查询参数匹配
  如果你启动Wiremock的时候加了--disable-query-params-matching这类参数，那Wiremock会忽略所有queryParameters的配置，只能通过完整URL来匹配请求。检查一下你的启动命令，确保没有添加这类禁用参数。

给你一个正确的Stub配置示例，你可以参考下：

{
  "request": {
    "method": "GET",
    "urlPath": "/posts",
    "queryParameters": {
      "id": {
        "equalTo": "1"
      }
    }
  },
  "response": {
    "status": 200,
    "body": "{\"id\": 1, \"title\": \"Sample Post\"}",
    "headers": {
      "Content-Type": "application/json"
    }
  }
}

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