Pact测试出现Unexpected Request body 500错误如何解决

Pact消费者契约测试的核心逻辑是：Mock服务收到请求时，会严格对照预先定义的契约规则做匹配，只要不满足规则就会直接判定为Unexpected Request，不会将请求转发到业务逻辑，最终返回500错误。你当前的问题本质是定义的契约请求体和实际请求类的序列化结构完全不匹配，具体偏差点如下：

• 字段缺失：请求类中实际会序列化的tags（字符串列表）、data（字符串）、additionalInfo（字符串键值对Map）三个字段，在Dsl定义中完全没有声明，Pact会判定契约要求的字段缺失。
• 冗余字段：Dsl中定义了请求类根本不存在的template字符串字段、metadata嵌套对象（包含detail-type字符串字段），实际发送请求时不会携带这两个字段，默认严格匹配模式下Pact会判定请求结构不符合预期。
• 类型定义错误：
  • action是枚举类型，JSON序列化后为字符串值，你当前将其定义为空Object类型
  • timeZone是ZoneId类型，JSON序列化后为Asia/Shanghai这类字符串格式时区ID，你当前也将其定义为空Object类型
    类型不匹配会直接导致校验失败。

1. 重写Dsl请求体定义，和实际请求类的字段、序列化后的JSON类型一一对应，删除冗余字段、补全缺失字段、修正错误类型，参考代码如下：

// 最后一个构造参数传true代表开启忽略额外字段，适配动态扩展字段场景
DslPart body = new PactDslJsonBody(null, null, false, true)
        // 基础字符串字段对齐
        .stringType("pk")
        .stringType("sk")
        .stringType("pattern")
        .stringType("target")
        .stringType("data")
        // 修正枚举、时区字段类型：序列化后为字符串，用stringType匹配
        .stringType("action")
        .stringType("timeZone")
        // 补全字符串列表类型的tags字段
        .array("tags").stringType().closeArray()
        // 补全字符串Map类型的additionalInfo字段
        .object("additionalInfo")
            .eachKeyLike()
            .stringType() // 匹配所有key对应的value为字符串类型
            .closeObject();

2. 校验注意事项：
   • 所有请求类中会序列化到JSON的字段，都要在Dsl中声明对应类型的匹配规则，不要漏写
   • 不要保留任何请求类中不存在的冗余字段定义，避免和实际请求结构冲突
   • 枚举、时间、时区这类序列化后为字符串/数字等基础类型的字段，不要错误定义为Object类型，要对齐实际序列化后的JSON类型
   • 如果业务场景允许请求携带动态扩展字段，初始化PactDslJsonBody时开启ignoreExtraElements配置（即构造函数最后一个布尔参数传true），避免未声明的扩展字段触发匹配失败。

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