为什么 PactGo 的 VerifyProvider 总是报 no interactions found
根本原因不是 Pact 文件没生成，而是 Provider 验证时没正确加载 Pact 文件路径或没匹配到对应 Consumer 名称。PactGo 默认只读当前目录下的 pacts/，且要求文件名严格符合 {consumer-name}-{provider-name}.json 格式。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
pact-go的VerifyProvider时，显式传入PactURLs，别依赖自动扫描：err := p.VerifyProvider(t, types.VerifyRequest{ ProviderBaseURL: "http://localhost:8080", PactURLs: []string{"./pacts/myapp-frontend-myapp-backend.json"}, }) - 检查 Pact 文件里
consumer.name和provider.name是否与验证时的--provider-name（或代码中ProviderName）完全一致，大小写、连字符都不能错 - 运行验证前确认 Provider 已启动且能响应真实请求——
VerifyProvider是发真实 HTTP 请求去比对响应，不是静态分析 JSON
Go 测试里怎么让 Pact 桩服务（Mock Server）和实际 Handler 共存
常见错误是直接在 TestMain 启 Pact Mock Server，结果测试跑完没关，端口被占；或者把桩逻辑硬塞进业务 handler，导致契约和实现耦合。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
pact-go/dsl启独立 Mock Server，绑定到随机空闲端口：mockServer, err := pact.NewMockService().Start("localhost", 0)，然后把mockServer.URL注入测试用的 client - 业务 handler 保持纯净，不加任何
if testing分支；契约测试走 Mock Server，集成测试才调真实 Provider - 务必在
test cleanup阶段调mockServer.Stop()，否则并发测试容易因端口冲突失败
PactGo 的 WithRequest 和 WithResponse 参数哪些不能省略
省略关键字段会导致验证时匹配失败，但错误信息很模糊，比如只报 mismatch 而不提示具体哪项没对上。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 必须显式声明
Method、Path、Status——它们是匹配基准，缺一不可 - Query 参数要展开写进
Query字段，别拼在Path里；Path只留路径部分，如/api/users，不是/api/users?id=123 - Body 匹配默认是严格相等，如果字段有动态值（如时间戳、ID），得用
Like或EachLike，否则验证必过不了：body: dsl.Like(map[string]interface{}{"id": dsl.Integer(), "name": dsl.String()})
本地跑通后 CI 失败：Go + PactGo 的环境兼容性坑
本地 macOS/Windows 能过，CI（通常是 Linux Docker）报错，多数卡在 Pact CLI 二进制缺失或权限问题。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 不要靠
go get安装 Pact CLI；改用curl下载对应平台的二进制，放进$PATH：curl -L https://github.com/pact-foundation/pact-cli/releases/download/v1.10.0/pact-cli_1.10.0_Linux_x86_64.tar.gz | tar xz -C /usr/local/bin
- 确保 CI 环境的 Go 版本 ≥ 1.19（
pact-gov1.1+ 强依赖io/fs和泛型） - CI 中避免用
go test ./... -race跑 Pact 测试——pact-go内部用临时文件和进程通信，竞态检测会干扰它
最易被忽略的是 Pact 文件的时间戳校验：Provider 验证时会检查 Pact 文件里的 createdAt 是否早于当前时间 7 天，CI 时间不同步或文件系统挂载方式异常都可能触发这个隐性限制。
