Wiremock映射匹配异常：x-www-form-urlencoded请求未命中指定规则

问题根源 #

你使用的multipartPatterns匹配器仅对multipart/form-data类型的请求生效，而你发送的是application/x-www-form-urlencoded格式的请求，Wiremock不会用multipartPatterns去匹配这类请求，导致优先级1的规则直接被跳过，最终匹配到优先级2的通用映射。

正确的匹配配置 #

针对application/x-www-form-urlencoded请求，应该使用formParameters匹配器——它会自动解析URL编码的表单参数，比直接匹配原始请求体（bodyPatterns）更可靠。

优先级1的映射示例（JSON格式） #

{
  "priority": 1,
  "request": {
    "method": "POST",
    "urlPattern": "/.*", // 可根据Twilio API实际路径调整
    "headers": {
      "Content-Type": {
        "contains": "application/x-www-form-urlencoded"
      }
    },
    "formParameters": {
      "Body": { // 注意参数名要和Twilio实际参数一致，比如是否为小写body？
        "contains": "should-fail"
      }
    }
  },
  "response": {
    "status": 500,
    "body": "Mocked Twilio failure"
  }
}

为什么bodyPatterns可能无效 #

如果之前尝试用bodyPatterns，需要匹配的是URL编码后的原始请求体字符串，比如Body=should-fail或带其他参数的Body=should-fail&From=+123456789。一旦请求参数顺序变化、有额外参数，或者参数值包含URL编码字符（比如空格转成+或%20），contains匹配就会失效。而formParameters基于Wiremock解析后的参数，不受这些因素影响。

验证步骤 #

1. 查看Wiremock的请求日志（Docker容器日志，或访问Wiremock的/admin/requests端点），确认请求的Content-Type是否正确，表单参数是否被正确解析。
2. 检查参数名是否完全匹配（Twilio的消息体参数大小写敏感，比如是Body还是body）。

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