WireMock映射匹配规则解析及Spring Cloud Contracts映射优先级疑问

匹配的两个核心阶段 #

WireMock处理请求匹配时，会分候选映射筛选和优先级排序选择两个阶段，这就是你遇到问题的根源：

1. 候选筛选：先找所有符合基础规则的映射

   • 首先会筛选出所有满足「HTTP方法、URL路径（或完整URL）、已定义的请求头」的映射。
   • 关键点：如果某个映射没定义查询参数、请求体这类规则，WireMock会认为这些规则对该映射不做要求——也就是说，不带查询参数的映射，会匹配所有路径一致的请求，不管请求有没有带查询参数。
   • 你的场景里，带查询参数的请求同时符合两个映射的规则：带查询参数的映射（满足所有定义的规则），以及不带查询参数的映射（因为它没限定查询参数，所以请求带参数也符合）。

2. 优先级排序：从候选里挑最高优先级的映射

   • 当有多个候选映射时，WireMock会按优先级数值从小到大选择（数值越小，优先级越高）。
   • 默认所有映射的优先级都是5，这时会按映射加载的顺序选第一个匹配的。你之前没设优先级时，不带查询参数的映射可能先被加载，所以带参数的请求返回了它的响应。

你的场景为什么加优先级就好使 #

• 未设置优先级：两个映射优先级相同，WireMock按加载顺序匹配，不带查询参数的映射先被命中，所以返回了错误的响应。
• 设置优先级后：带查询参数的映射优先级设为1（比2高），所以在候选列表里会被优先选中，返回正确的结果。

关于“查询参数应该更优先”的误解 #

这是对WireMock规则逻辑的误读：

• 映射里的规则是**“必须满足的条件”**，不是“用来区分优先级的依据”。不带查询参数的映射没定义查询参数规则，等于允许请求带任意查询参数（包括带exclusions的情况），所以它会进入候选列表。
• 如果你想让不带查询参数的映射只匹配没有查询参数的请求，可以给它加明确的查询参数规则：

  "queryParameters": {
    "exclusions": {
      "doesNotExist": true
    }
  }
  

  这样，带查询参数的请求就不会匹配这个映射，也就不用依赖优先级来区分了。

额外补充：单个映射内的规则校验顺序 #

对于单个映射，WireMock会按以下顺序校验规则，全部满足才会视为匹配：

• HTTP请求方法
• URL路径/完整URL
• 请求头（如果映射里定义了）
• 查询参数（如果映射里定义了）
• 请求体/请求体匹配规则（如果映射里定义了）

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