PactNet 4.0使用Regex匹配器时契约验证失败问题咨询

问题结论 #

PactNet 4.0 原生支持Regex及所有V3版本规范的匹配器，你遇到的校验失败不是版本功能缺失，是写法错误导致匹配器规则没有被正确写入契约文件。

根因说明 #

你当前的写法是先构造C#匿名类型对象，将Match.Regex()返回的匹配器实例直接作为匿名类型的属性值，再把整个匿名对象传入WithJsonBody方法。
这个流程下，匿名类型序列化时会把匹配器实例当做普通CLR对象处理，匹配器携带的规则元数据（正则表达式、示例值）会完全丢失，最终生成的契约文件里sku字段既没有正确的示例值，也没有匹配规则，提供者端校验时自然会失败。这也是你更换其他匹配器仍然报错的核心原因，和正则表达式本身写法无关。

修复方法 #

不要提前构造包含匹配器的匿名对象，直接在WithJsonBody的入参委托中，用Pact提供的Body构造器逐字段定义响应结构，参考修改后的代码：

pactBuilder
    .UponReceiving("Get product with id 10")
    .WithRequest(HttpMethod.Get, "/api/products/10")
    .WillRespond()
    .WithStatus(HttpStatusCode.OK)
    .WithHeader("Content-Type", "application/json; charset=utf-8")
    .WithJsonBody(resBody => resBody
        .Property("id", 10)
        .Property("name", "Shirt")
        .Property("sku", Match.Regex("SKU10", "^SKU.+$"))
        .Property("price", 100.00M)
    );

如果需要复用结构定义，不要使用原生C#匿名类型承载匹配器，改用Pact官方提供的匹配器构造类来构建对象，保证匹配器元数据能被正确识别序列化。

补充排查项 #

如果调整写法后仍有匹配器失效问题，检查以下几点：

• 确认PactHelper.GetPactConfiguration()中没有开启旧版匹配器序列化的兼容开关，旧版序列化逻辑不兼容V3版本的匹配器规则
• 确认项目中所有PactNet相关依赖包（核心库、NativeBackend适配包等）版本完全一致，跨大版本的包混装会导致匹配器解析逻辑异常
• 正则规则注意正确性：你原来写的SKU*从正则语法上匹配的是SK后接0到多个U的字符串，Pact做正则匹配时默认要求字段值完全符合正则规则，即使匹配器正常生效，"SKU10"这类带后缀的sku值也会校验失败，如果要匹配SKU开头的字符串，需要调整为带首尾锚点的完整规则比如^SKU.*$。

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