如何配置Wiremock将无匹配映射的请求代理至指定地址？

这个需求完全可以实现，下面提供两种常用的实现方案：

方法一：使用全局Fallback Proxy（官方原生支持） #

这是最简便的实现方式，直接通过WireMock的配置即可完成，无需额外代码开发。

• Java代码启动方式：

  WireMockServer wireMockServer = new WireMockServer(options()
      .port(8080)
      .proxyAllTo("http://www.my-address.com")
      .enableBrowserProxying(true));
  wireMockServer.start();
  

  其中proxyAllTo指定了无匹配映射时的代理目标地址，enableBrowserProxying(true)用于确保代理能正确处理浏览器相关的请求头（如Cookie、Referer等）。

• 独立Jar启动方式：
  使用命令行参数直接配置：

  java -jar wiremock-jre8-standalone-2.35.0.jar --proxy-all-to http://www.my-address.com --port 8080
  

  启动后，所有未匹配到Stub映射的请求都会自动转发到http://www.my-address.com。

方法二：自定义扩展实现灵活控制 #

如果需要根据请求路径、方法等条件添加自定义逻辑，可以通过WireMock的扩展机制实现。

步骤1：实现ResponseDefinitionTransformer #

public class FallbackProxyTransformer extends ResponseDefinitionTransformer {
    @Override
    public ResponseDefinition transform(Request request, ResponseDefinition responseDefinition, FileSource files, Parameters parameters) {
        // 无匹配Stub时，responseDefinition为null
        if (responseDefinition == null) {
            return new ResponseDefinitionBuilder()
                .proxiedFrom("http://www.my-address.com")
                .build();
        }
        return responseDefinition;
    }

    @Override
    public String getName() {
        return "fallback-proxy";
    }

    @Override
    public boolean applyGlobally() {
        return true; // 设置为全局生效
    }
}

步骤2：注册扩展并启动WireMock #

WireMockServer wireMockServer = new WireMockServer(options()
    .port(8080)
    .extensions(new FallbackProxyTransformer()));
wireMockServer.start();

这种方式可以灵活扩展逻辑，比如仅代理特定路径前缀的请求、修改请求头后再转发等。

注意事项 #

• 建议使用WireMock 2.27.0及以上版本，确保相关API稳定可用。
• 如果需要记录代理的请求以便后续生成Stub，可以添加--record-mappings参数（独立Jar启动时）或在代码中配置记录功能。
• 若涉及前端跨域请求，需在WireMock中配置CORS头，或确保目标地址允许跨域访问。

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