Java 17下Pact测试日期匹配规则失效问题排查

问题现象 #

系统迁移后部分Pact测试失败，契约中针对$.entity.month字段配置了yyyy-MM格式的日期匹配规则，但测试时默认使用yyyy-MM-dd格式校验，报错信息如下：

1.1) body: $.entity.month Expected "2023-02" to match a date of 'yyyy-MM-dd': Unable to parse the date: 2023-02

契约中的匹配规则配置：

"$.entity.month": {
  "matchers": [
    {
      "match": "date",
      "format": "yyyy-MM"
    }
  ]
}

使用的Pact Maven依赖（版本均为4.1.24）：

<dependency>
    <groupId>au.com.dius.pact</groupId>
    <artifactId>consumer</artifactId>
    <version>4.1.24</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>au.com.dius.pact.consumer</groupId>
    <artifactId>java8</artifactId>
    <version>4.1.24</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>au.com.dius.pact.consumer</groupId>
    <artifactId>junit5</artifactId>
    <version>4.1.24</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>au.com.dius.pact.provider</groupId>
    <artifactId>junit5</artifactId>
    <version>4.1.24</version>
    <scope>test</scope>
</dependency>

排查与解决方案 #

1. 修正契约匹配器格式 #

Pact V3及以上版本的匹配规则语法要求将匹配器放在matchingRules顶层节点下，而非嵌套在字段内容中。旧格式会导致format参数不被识别，修正后的契约结构示例：

{
  "matchingRules": {
    "$.entity.month": {
      "match": "date",
      "format": "yyyy-MM"
    }
  }
}

2. 确保测试代码日期格式正确 #

消费者端测试中，明确指定日期字段的生成格式，避免序列化工具自动添加日信息。例如使用Java 8的DateTimeFormatter：

DateTimeFormatter monthFormatter = DateTimeFormatter.ofPattern("yyyy-MM");
String targetMonth = YearMonth.now().format(monthFormatter);

3. 验证依赖兼容性与环境 #

• 确认所有Pact依赖版本完全一致，避免版本冲突导致的功能异常。
• Pact 4.x系列要求Java 8及以上运行环境，检查系统迁移后的Java版本是否符合要求。
• 若问题持续，尝试升级到Pact最新稳定版本（如4.5.x），部分旧版本存在日期匹配器的已知bug。

4. 检查提供者端输出逻辑 #

确认提供者返回的month字段严格为yyyy-MM格式，无额外日信息；同时排查提供者端Pact验证配置，是否存在覆盖契约匹配规则的自定义逻辑。

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