Pact V4迁移时Header匹配异常问题求助

问题背景 #

正在从Pact V3迁移到V4，原有V3代码可正常运行，但迁移到V4后出现请求头匹配错误。

V3工作代码 #

@Pact(consumer = CONSUMER, provider = PROVIDER)
RequestResponsePact provider(PactDslWithProvider builder) {
  return builder
      .uponReceiving("get")
      .method("GET")
      .headers("accept", "application/json, application/*+json")
      .path("/test")
      .willRespondWith()
      .status(200)
      .toPact()
}

V4迁移后代码 #

@Pact(consumer = CONSUMER, provider = PROVIDER)
V4Pact provider(PactBuilder builder) {
  return builder
      .expectsToReceiveHttpInteraction("get") { httpBuilder ->
        httpBuilder
            .withRequest { httpRequestBuilder ->
              httpRequestBuilder
                  .path("/test")
                  .method("GET")
                  .headers("accept", "application/json, application/*+json")
            }
            .willRespondWith { httpResponseBuilder ->
              httpResponseBuilder.status(200)
            }
      }
      .toPact()
}

报错信息 #

2025-01-16 11:41:50,475 [HTTP-Dispatcher] ERROR  a.c.d.p.c.BaseMockServer$Companion - PartialRequestMatch: get:
    Expected header 'accept' to have value 'application/json' but was 'application/json, application/*+json'
    Expected header 'accept' to have value 'application/*+json' but was ''

尝试过使用header方法替代headers，但错误依旧。

解决方案 #

问题根源 #

Pact V4的新DSL默认会将逗号分隔的请求头值拆分为多个独立的头值，而V3中是将其作为单个完整值处理。这就导致V4中"application/json, application/*+json"被拆成了两个期望的头值，与实际请求的单个头值不匹配。

解决方法 #

1. 传递列表格式的单个值

使用header方法，将头值包装在列表中，避免自动拆分：

httpRequestBuilder
    .path("/test")
    .method("GET")
    .header("accept", Arrays.asList("application/json, application/*+json"))

2. 使用匹配器显式定义匹配规则

通过正则匹配器指定完整的头值格式，绕过自动拆分逻辑：

import au.com.dius.pact.core.model.matchingrules.Matchers;

// ...

httpRequestBuilder
    .path("/test")
    .method("GET")
    .header("accept", Matchers.regexp("application/json, application/\\*\\+json"))

3. 全局关闭头值自动拆分

如果项目中大量存在此类逗号分隔的请求头，可以通过配置全局禁用自动拆分：

• 添加配置文件pact.properties：

  pact.split.headers=false
  

• 或在代码中设置：

  au.com.dius.pact.core.support.Config.setSplitHeaders(false);
  

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