Pact 4.0.0提供者验证未调用provider-states接口问题咨询

架构老林

2026-8-29

问题成因

Pact.Net 4.0.0版本调整了Provider State（提供者状态）中间件的运行逻辑，对中间件在ASP.NET Core请求管道中的注册顺序有强制要求：ProviderStateMiddleware属于短路型中间件，只有注册在管道靠前位置，才能直接拦截Pact验证进程发送的状态设置请求。如果将该中间件放在UseRouting()、UseEndpoints()、授权中间件或业务端点注册逻辑之后，发往/provider-states的状态设置请求会被后续路由中间件判定为不存在匹配端点直接返回404，根本不会进入状态中间件的处理逻辑，也就不会产生对应路径的访问日志，测试需要的前置状态自然无法正确设置。
4.0.0版本发布初期配套的示例存在疏漏，未明确标注中间件的注册顺序要求，参照旧版本示例编写代码的用户基本都会踩中这个顺序问题。
在测试类构造函数中硬编码配置提供者状态能通过测试，本质是跳过了Pact验证流程中“每个交互用例执行前动态设置对应状态”的环节，提前预置了所有测试用例需要的上下文，属于绕过问题的临时方案，无法适配多状态交互场景的验证需求。

解决方法

调整测试服务的请求管道中间件顺序，必须将ProviderStateMiddleware注册在所有路由、授权、业务端点相关中间件之前，正确注册示例代码如下：

var app = builder.Build();

// 提供者状态中间件必须放在管道最前端，在UseRouting之前注册
app.UseProviderState(stateConfig =>
{
    // 显式指定状态路径，避免小版本默认值不一致问题
    stateConfig.ProviderStateUri = "/provider-states";
    // 注册各个pact契约中定义的提供者状态对应处理逻辑
    stateConfig.Add("存在ID为1的测试用户", () =>
    {
        // 执行测试数据插入、mock配置等状态初始化操作
    });
    stateConfig.Add("订单列表为空", () =>
    {
        // 执行测试数据清理操作
    });
});

// 路由、授权、业务接口映射等逻辑全部放在状态中间件之后
app.UseRouting();
app.UseAuthorization();
app.MapControllers();
// 其余业务中间件按原有顺序注册即可

app.Run();

注册完成后可做简单校验：本地启动测试服务，向/provider-states路径发送格式符合Pact规范的POST请求，如果能返回200状态码且触发对应状态的处理逻辑，说明中间件注册生效。后续执行提供者验证测试时，日志中会正常出现/provider-states路径的调用记录，每个用例的前置状态会被正确设置，无需在构造函数中硬编码预置状态。
如果使用4.0.0-4.0.2的早期小版本，需要注意状态路径匹配是大小写敏感的，必须保证服务端配置的ProviderStateUri和Pact验证端配置的状态路径完全一致，避免出现路径匹配失败问题。

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