根本原因是 Pact 初始化时 consumer 和 provider 名称必须完全一致（含大小写、空格、连字符），且不能动态拼接；常见错误包括名称不匹配、URL 未替换为 mock 地址、provider 状态或路径未对齐、端口冲突及临时文件残留。
为什么 Pact-Go 生成的 pact 文件里 consumer 和 provider 名字总对不上
根本原因是 Pact 初始化时传入的 consumer 和 provider 名称，必须和后续所有测试、验证、发布环节中使用的名称**完全一致（包括大小写、空格、连字符）**，且不能动态拼接。
常见错误现象：pact-go 启动 provider 验证时抛出 no interactions found for consumer "MyConsumer"，但实际代码里写的是 "my-consumer"；或者 CI 中 pact broker 发布用的是环境变量 $CONSUMER_NAME，而测试里硬编码了 "consumer-dev"。
- 初始化
Pact实例时，Consumer和Provider字段只接受字符串字面量，不支持变量或函数调用 - 所有测试文件、验证脚本、broker 发布命令中的名称必须逐字符匹配——建议统一定义在
const中，例如const ConsumerName = "order-service-client" - 如果用了 pact broker，发布前检查
pact publish命令里的--consumer-app-version是否和测试中WithPactURLOptions指向的版本一致，否则 broker 会找不到对应契约
如何让 Go 测试真正触发 Pact mock server 并捕获请求
关键不是“启动 mock”，而是让被测代码的 HTTP 客户端实际连接到 Pact 启动的本地服务地址——这需要显式替换原始 URL，且不能依赖全局配置或 init 函数提前固化。
使用场景：你写了 client := NewOrderClient("https://api.example.com")，但测试里没改掉这个地址，结果请求发到了真实环境或 404，mock 根本没被调用。
立即学习“go语言免费学习笔记（深入）”；
- 测试中必须把 client 初始化逻辑抽成可参数化函数，例如
NewOrderClient(baseURL string) - 在
Before钩子中调用pact.Server().URL()获取当前 mock 地址，并传给 client 构造函数 - 确保 client 使用标准
http.Client，不要自定义 transport 或禁用 redirect，否则 Pact 的中间层可能无法拦截请求 - 示例：
client := NewOrderClient(pact.Server().URL())—— 这行必须出现在每个测试用例内部或SetupTest里，不能只在包级变量中设一次
provider 验证失败时，错误信息里提示 “interaction not found” 怎么定位
这不是网络不通或服务未启动的问题，而是 Pact 在比对时发现：provider 端模拟的接口响应格式 / 路径 / 方法 / 请求体结构，和 consumer 测试中定义的契约存在不可忽略的差异。
典型表现：本地跑 pact verify 报错，但手动 curl provider 接口返回 200；或者日志显示 “expected status 200 but got 200”，却依然失败——说明问题出在 body、headers 或 path 参数上。
- 先运行验证时加
--log-level=DEBUG，查看 pact 输出的完整 request/response diff，重点关注body字段是否多字段、少字段、类型不符（如 string vs number） - provider state setup 函数返回的
map[string]interface{}必须和 consumer 测试中Given("user exists")对应的状态名严格一致 - 如果 consumer 测试中用了正则匹配路径（如
/users/[0-9]+），provider 验证时的路由必须能匹配该模式，不能写死成/users/123 - 注意 JSON 中空数组
[]和null在 Pact 中被视为不同值，consumer 测试里定义的 example body 必须和 provider 实际返回一致
CI 中集成 Pact-Go 时，如何避免 “port already in use” 或临时文件残留
Pact-Go 默认复用本地 6666 端口启动 mock server，且会在 /tmp 下生成临时目录存日志和 pact 文件；多个并行测试或重复执行极易冲突。
性能与稳定性影响：端口占用导致测试随机失败；临时文件堆积可能撑爆磁盘或污染下一次运行环境。
- 每次测试前调用
pact.SetLogLevel("WARN")并设置唯一端口：pact = New(Pact{Port: 6667 + rand.Intn(100)}) - 测试结束后显式调用
pact.Teardown()，它会停 server、删临时目录——别依赖 defer，因为 test runner 可能并发执行 - CI 脚本中，在
pact verify前加rm -rf ./pacts，防止旧 pact 文件干扰新验证 - 如果用 GitHub Actions，记得在
steps末尾加cleanup: true到 pact-go action，否则容器退出后临时文件还在
UponReceiving，都要在 provider 验证时有对应状态函数和路由实现——少一个，整个验证就静默跳过，而不是报错。 
