JVM环境下Pact如何忽略请求中的查询参数适配契约匹配？

完全可以实现，JVM（Java/Scala）环境下有两种常用方案解决这个问题：

方案一：利用Pact原生API忽略指定查询参数 #

这是最直接的方式，在消费者端定义Pact契约时，明确指定要忽略的查询参数（比如你的apiKey）。Mock Server会自动忽略该参数的存在，只匹配契约中定义的其他参数。

Java示例 #

PactDslWithProvider pactBuilder = new PactDslWithProvider("你的提供者服务名")
    .given("前置状态描述")
    .uponReceiving("带API key的请求")
    .path("/目标接口路径")
    .method("GET")
    .ignoredQueryParameters("apiKey") // 这里指定要忽略的参数名
    .willRespondWith()
    .status(200)
    .body("{\"result\": \"success\"}");

Scala示例 #

val pact = Consumer("你的消费者服务名") hasPactWith Provider("你的提供者服务名") {
    given("前置状态描述")
    uponReceiving("带API key的请求")
    .path("/目标接口路径")
    .method("GET")
    .ignoredQueryParameters("apiKey")
    .willRespondWith(Status.Ok, Body("{\"result\": \"success\"}"))
}

方案二：请求拦截器移除参数 #

如果因为某些原因无法修改契约定义，可以在消费者测试中加入请求拦截逻辑，在请求到达Mock Server之前自动移除apiKey参数。

Java Spring环境示例 #

@Bean
public RestTemplate pactTestRestTemplate() {
    RestTemplate restTemplate = new RestTemplate();
    restTemplate.getInterceptors().add((request, body, execution) -> {
        URI originalUri = request.getURI();
        // 移除apiKey参数
        String cleanedQuery = Optional.ofNullable(originalUri.getQuery())
                .map(query -> query.replaceAll("apiKey=[^&]*&?", ""))
                .map(query -> query.endsWith("&") ? query.substring(0, query.length() - 1) : query)
                .orElse(null);

        URI modifiedUri = UriComponentsBuilder.fromUri(originalUri)
                .replaceQuery(cleanedQuery)
                .build()
                .toUri();

        HttpRequest modifiedRequest = new HttpRequestWrapper(request) {
            @Override
            public URI getURI() {
                return modifiedUri;
            }
        };
        return execution.execute(modifiedRequest, body);
    });
    return restTemplate;
}

两种方案对比：方案一符合Pact契约测试的设计原则，配置简单且无额外代码维护成本，优先推荐；方案二适合特殊场景，但需要额外维护拦截器逻辑。

内容的提问来源于stack exchange，提问作者Gaël J