如何在WireMock映射中匹配请求头的字符数组值？

安全阿岳

2026-7-14

WireMock匹配字符数组类型请求头的解决方案

问题原因

WireMock默认的equalTo匹配器仅支持字符串类型的操作数，直接传入字符数组会触发equalTo operand must be a non-null string初始化错误。

解决方案

根据请求头中字符数组的实际传输格式，选择以下适配方案：

方案1：请求头值为JSON序列化的字符数组

如果客户端发送的apiKey请求头是JSON格式的字符串（如["t","e","s","t"]），使用equalToJson匹配器直接匹配JSON结构：

"request": {
  "urlPathPattern": "/some/url",
  "method": "GET",
  "headers": {
    "apiKey": {
      "equalToJson": "[\"t\",\"e\",\"s\",\"t\"]"
    }
  }
}

方案2：请求头值为自定义格式的字符数组

如果字符数组以其他格式（如逗号分隔的t,e,s,t）传输，使用matchesScript脚本匹配器自定义校验逻辑（以Groovy脚本为例）：

"request": {
  "urlPathPattern": "/some/url",
  "method": "GET",
  "headers": {
    "apiKey": {
      "matchesScript": {
        "scriptEngineName": "groovy",
        "script": "def headerValue = request.headers.getFirst('apiKey'); def expectedArray = ['t','e','s','t']; headerValue.split(',').collect { it.trim() } == expectedArray"
      }
    }
  }
}

根据实际的分隔符或格式，调整脚本中的解析逻辑即可。