go-pact启动失败主因是未手动启动Pact Mock Server；需npm安装pact-cli后运行pact-mock-service，Go端显式配置Host/Port，并用轮询检测服务就绪。
为什么 Pact 在 Go 里跑不起来：go-pact 启动失败的典型原因
Go 的 Pact 实现（go-pact）不是开箱即用的独立服务，它依赖本地运行的 Pact Broker 或 Pact Mock Server —— 很多人卡在第一步，是因为直接调 go run main.go 就报错 connection refused，其实根本没起 mock server。
- 必须手动启动 Pact Mock Server：
pact-mock-service --port 1234 --host localhost（需提前npm install -g pact-cli） -
go-pact默认连http://localhost:1234，端口/地址不匹配会静默失败，建议显式传参：NewPact(PactConfig{Host: "localhost", Port: 1234}) - Go 模块未启用或
go.sum冲突时，go-pact的Verify方法可能 panic 而非返回 error，务必用defer/recover包一层再调试
消费者测试写法：如何让 Go 客户端生成合法的 pact 文件
Go 消费者测试本质是「描述自己期望的 HTTP 请求与响应」，不是发真实请求。常见误区是把 http.Client 直接塞进测试逻辑，结果 pact 文件里全是空交互或 status 0。
- 所有 HTTP 调用必须走
pact.MockServiceURL()返回的地址，例如：resp, _ := http.Get(pact.MockServiceURL() + "/api/users/123") - 每个交互需显式定义，不能靠中间件或封装函数隐式触发 ——
pact.AddInteraction()必须在测试函数内、HTTP 调用前完成 - 响应体类型要严格匹配：如果契约声明了
Content-Type: application/json，但实际返回的是text/plain，验证阶段会失败，且错误信息只提示「mismatched headers」，容易漏看
提供者验证失败：go-pact-provider-verifier 找不到 pact 文件或状态码对不上
Provider 验证不是自动扫描目录，它依赖明确的 pact URL 或本地路径，且对 provider 端接口的 HTTP 状态码、响应头、JSON 字段名大小写极度敏感。
- 验证命令中的
--pact-url必须指向 .json 文件（如./pacts/consumer-provider.json），不能是目录；若用 Broker，URL 格式为https://broker/pacts/provider/xxx/consumer/yyy/version/1.0.0 - Provider 接口返回的 status code 必须和 pact 文件中
status字段完全一致 —— 即使业务上 201 和 200 可互换，契约里写的是 200，你就得临时改 handler 返回 200 - JSON 响应体中字段顺序无关，但字段名大小写必须一字不差；
UserID和userid被视为不同字段，验证直接失败
CI 环境下 pact 验证总超时：Go 测试并发与 Pact Server 的资源冲突
本地跑通的测试，在 CI（如 GitHub Actions）里频繁出现 timeout waiting for mock server，主因是 Pact Mock Server 启动慢 + Go 测试并发抢占端口。
立即学习“go语言免费学习笔记（深入）”；
- 避免并行执行多个 pact 测试：在
go test中加-p 1限制并发数 - Mock Server 启动后需等待就绪，不要用固定
time.Sleep(2 * time.Second)—— 改用轮询：http.Get("http://localhost:1234/status")直到返回 200 - CI 中优先用 Docker 启 Pact Server：
docker run -d -p 1234:1234 --name pact-mock pactfoundation/pact-cli:latest mock-service --port 1234，比 npm 全局安装更稳定
契约测试真正的难点不在语法，而在于消费者和提供者团队对同一份 JSON 结构的隐含理解是否一致 —— 比如一个 created_at 字段，消费者认为是字符串，提供者按 time.Time 序列化成数字时间戳，pact 文件里没写 type，验证就过不去。这种细节，mock server 不报错，只有 provider 验证时才暴露。
