WireMock中QueryParams传递数组参数返回404如何配置匹配规则

返回404的核心原因有两点：

• 原有正则匹配规则^[a-zA-Z0-9_-]*$仅支持匹配由字母、数字、下划线、横杠组成的字符串，而待匹配的参数值[{age=6,name=AAA}]包含[、]、{、}、=、,等特殊字符，完全不符合原有正则的匹配范围，无法命中对应Stub规则。
• 直接在curl的URL中拼接特殊字符时，容易出现转义异常、URL编码不符合预期的问题，导致WireMock实际收到的参数值和你预期的不一致。

编写适配的参数匹配规则 #

HTTP协议中Query参数的所有值本质都是字符串，[{age=6,name=AAA}]只是字符串内容形似数组对象，WireMock不会自动解析该结构，直接按普通字符串编写匹配规则即可：

1. 如果仅需要匹配参数格式、不校验内部具体字段值（满足透传需求），可使用如下正则配置：

"queryParameters": {
  "Person": {
    "matches": "^\\[\\{.*\\}\\]$"
  }
}

注意：JSON格式中反斜杠需要转义，因此正则里的转义符\要写成\\

2. 如果需要精确校验参数内的字段值，比如必须包含age=数字、name=字符的结构，可使用更严格的正则：

"queryParameters": {
  "Person": {
    "matches": "^\\[\\{age=\\d+,name=[a-zA-Z0-9_-]+\\}\\]$"
  }
}

3. 如果不需要校验Person参数的任何格式，只要请求携带该参数就放行透传，可直接用存在性判断，无需编写复杂正则：

"queryParameters": {
  "Person": {
    "absent": false
  }
}

配置好匹配规则后，在Stub的响应中配置proxyBaseUrl指向要透传的目标服务地址即可，WireMock匹配成功后会自动携带原始Query参数转发请求，无需额外配置透传逻辑。

修正curl测试命令 #

不要直接把带特殊字符的参数拼在URL路径中，避免转义异常，使用--data-urlencode参数让curl自动完成URL编码，示例命令：

curl -G "http://你的WireMock服务地址/接口路径" --data-urlencode "Person=[{age=6,name=AAA}]"

额外排查手段 #

如果调整配置后依然返回404，可以直接查看WireMock返回的404响应体，其中会明确标注当前收到的请求参数、路径信息，以及和所有已配置Stub的匹配差异点，对照差异调整规则即可快速定位问题。

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