契约struct必须带json tag和validate约束，缺json tag导致反序列化失败，缺validate tag使空值绕过校验；嵌套需dive，小写字段反射不可读，httpexpect分层断言状态码、header、body字段约束。
契约 struct 必须带 json tag 和 validate 约束
没字段约束的 struct 不是契约，只是空壳。Go 没有运行时 schema 解析器，所有校验必须靠 json tag 控制序列化键名、validate tag 触发字段级检查，否则 json.Unmarshal 成功但语义已错。
-
ID int `json:"id" validate:"required,gte=1"`—— 缺json:"id"，反序列化时字段永远收不到值；缺validate:"required"，空 ID 也能过校验 - 嵌套结构体必须加
dive：User User `json:"user" validate:"dive"`，否则User.Name不会被校验 - 别用
map[string]interface{}接响应体——它绕过所有 tag，等于放弃契约 - 字段名必须首字母大写，小写字段（如
name string）连反射都读不到，validate完全静默失效
httpexpect/v2 分层断言 status/header/body
契约测试只关心三件事：状态码是否在约定范围内、关键 header 是否精确匹配、body 是否能无 panic 解析并满足字段约束。字符串比对或正则模糊匹配会漏掉字段缺失、类型错位等硬伤。
- 用
.Status(200)，不是resp.StatusCode == 200—— 前者自动 fail 测试，后者需手动 assert -
.Header("Content-Type").Equal("application/json; charset=utf-8")—— header 名不区分大小写，但值必须一字不差 -
.JSON().Object().ContainsKey("id", "name")先查字段存在性，再用.ValueEqual("id", 123)校验值，避免手写json.Unmarshal+reflect.DeepEqual - 含时间戳、UUID 等动态值时，
httpexpect不支持 Like 语法，得先Unmarshal到 struct，再用validator跳过特定字段
PactGo VerifyProvider 报 no interactions found 的真实原因
不是 Pact 文件没生成，而是验证时根本没加载到正确文件。PactGo 默认只扫 ./pacts/ 下符合 {consumer}-{provider}.json 格式的文件，路径、命名、大小写错一个就静默失败。
- 显式传
PactURLs，别依赖自动扫描：PactURLs: []string{"./pacts/frontend-backend.json"} - 检查 Pact 文件里
consumer.name和provider.name是否与代码中ProviderName完全一致（连横线、大小写都不能错） - 验证前确认 Provider 已启动且可访问 ——
VerifyProvider是发真实 HTTP 请求去比对，不是静态分析 JSON - Mock Server 启动后必须调
mockServer.Stop()，否则并发测试端口冲突，no interactions found可能是端口被占导致请求失败
CI 中必须卡住 OpenAPI 与代码生成的一致性
Swagger YAML 和 Go struct 脱钩是线上 panic 的主要来源。CI 阶段不强制校验，上线后才发现字段少传、类型错位、枚举值越界，只能回滚。
立即学习“go语言免费学习笔记（深入）”；
- 用
go-swagger validate检查 YAML 语法和基础结构，再用swagger generate model生成 struct，最后 diff 生成代码与现有契约 struct 是否一致 - 若 spec 有
oneOf，go-swagger生成的 struct 会漏字段，此时应降级为json.RawMessage+ 手动json.Unmarshal分支校验 - 禁止在 CI 中跳过
go vet或go build—— 字段名大小写错误、tag 拼写错（如validata）会在编译期暴露，比运行时报 panic 更早 - Git tag 或
//go:embed同步 JSON Schema，避免开发本地改了 YAML 却没同步到测试代码
validator 反射读取、被 httpexpect 分层断言的 Go struct。 
