WireMock配置：如何让未映射请求失败并阻止访问远程服务？

API 探路者

2026-6-13

WireMock 阻止未映射请求访问远程服务的实现方法

有两种直接可行的方式实现你的需求，完全适配你提到的业务场景：

方法一：启用严格匹配模式（Strict Matching）

WireMock 内置严格匹配模式，开启后所有未匹配现有映射的请求会直接返回404 错误，不会转发到真实远程服务器。

配置方式：

Java 代码配置：

WireMockServer wireMockServer = new WireMockServer(options()
  .strictMatching(true)
  // 保留你原有代理、快照相关配置
);
wireMockServer.start();

JSON 配置文件（wiremock.json）：
```
{
  "strict_matching": true
}
```

开启后，任何未被已记录快照映射匹配的请求都会立刻被拦截返回404，不会触发远程调用，正好满足你提醒开发者更新快照、避免生产服务器限流的核心需求。

方法二：添加全局默认拒绝映射

如果需要自定义错误响应（比如返回特定状态码或提示文本），可以添加一个优先级最低的全局映射，兜底匹配所有未被其他映射覆盖的请求，直接返回失败响应。

Java 代码示例：

wireMockServer.stubFor(any(anyUrl())
  .atPriority(10) // 设置最低优先级，确保已有快照映射优先匹配
  .willReturn(aResponse()
    .withStatus(403)
    .withBody("未找到匹配的快照映射，请更新快照后重试")
  )
);

JSON 映射文件示例：

在mappings目录下创建default-deny.json文件：

{
  "request": {
    "method": "ANY",
    "urlPattern": ".*"
  },
  "response": {
    "status": 403,
    "body": "未找到匹配的快照映射，请更新快照后重试"
  },
  "priority": 10
}

这种方式灵活性更高，能通过自定义提示让开发者快速定位问题原因。