WireMock多值Query匹配失败求助（WireMock 3.5.4）

针对多id参数传递（?id=1&id=2）的配置修正 #

如果请求是重复传递同一个参数名的多值形式，核心问题大概率是匹配规则未声明支持多实例参数，或匹配逻辑有误：

1. 正确的多值参数匹配配置示例（匹配包含指定值的多实例参数）：

{
  "request": {
    "method": "GET",
    "urlPath": "/api/items",
    "queryParameters": {
      "id": {
        "contains": ["1", "2"],
        "multiple": true
      }
    }
  },
  "response": {
    "status": 200,
    "body": "Multi-id matched"
  }
}

• multiple: true必须添加，用于告知WireMock该参数允许出现多次；
• contains数组会校验所有传递的id值是否包含指定元素（顺序不影响）。

2. 若要严格匹配所有传递的值（比如仅接受id=1&id=2且顺序固定），可改用matches结合正则：

"queryParameters": {
  "id": {
    "matches": "(1.*2|2.*1)",
    "multiple": true
  }
}

针对逗号分隔id值（?id=1,2）的配置修正 #

这种场景下参数是单值但包含多个id，匹配逻辑需针对参数值内容：

1. 精确匹配指定逗号分隔值：

{
  "request": {
    "method": "GET",
    "urlPath": "/api/items",
    "queryParameters": {
      "id": {
        "matches": "^(1,2|2,1)$"
      }
    }
  },
  "response": {
    "status": 200,
    "body": "Comma-separated id matched"
  }
}

2. 宽松匹配（只要包含指定id即可，不管顺序和其他额外值）：

"queryParameters": {
  "id": {
    "matches": "^.*1.*,.*2.*$"
  }
}

通用排查步骤 #

• 验证映射加载状态：调用WireMock管理接口GET /__admin/mappings，检查匹配规则是否已正确加载，且JSON格式无语法错误（比如遗漏逗号、引号不闭合）。
• 开启 verbose 日志：启动WireMock时添加--verbose参数，查看实际接收的请求参数细节，对比匹配规则是否存在参数名大小写不一致、值格式不匹配等问题。
• 核对版本特性：WireMock 3.x部分语法与2.x不同，确认你使用的queryParameters匹配属性（如multiple）在3.5.4版本中有效。

内容的提问来源于stack exchange，提问作者Lukasz G.