直接用cmp.Equal会panic或误判Protobuf结构体，因其默认跳过未导出字段、不处理nil指针与空切片等价性，且遇func/unsafe.Pointer直接panic；而Protobuf相等性需忽略未设置字段、排序repeated、归一化oneof，必须显式使用protocmp.Transform()等选项适配其语义。
为什么直接用 cmp.Equal 会 panic 或误判 Protobuf 结构体
Protobuf 生成的 Go struct 默认包含大量未导出字段（如 XXX_unrecognized、XXX_sizecache）和指针字段，而 go-cmp 默认跳过所有未导出字段，也不处理 nil 指针与空切片的语义等价性。更关键的是：如果结构体里混有 func 或 unsafe.Pointer 类型（某些旧版 protobuf 插件生成），cmp.Equal 会直接 panic——它不像 reflect.DeepEqual 那样静默跳过，而是明确报错。
常见错误现象包括：
panic: cannot handle unexported field- 两个逻辑上相等的
proto.Message返回false，但cmp.Diff输出为空（因私有字段被忽略，导致“看似相等”） - 含
repeated字段的 message 对比失败，只因元素顺序不同（protobuf 本身不保证顺序）
必须加 protocmp.Transform() 才能安全对比
Protobuf 消息不是普通 Go struct，它的相等性语义由 proto 规范定义：忽略未设置字段、忽略顺序、支持 oneof 分支归一化。原生 cmp 完全不了解这些规则，所以必须显式注入 protobuf-aware 的比较逻辑。
正确做法是传入 protocmp.Transform() 作为选项：
if !cmp.Equal(got, want, protocmp.Transform()) {
t.Errorf("proto mismatch:\n%s", cmp.Diff(want, got, protocmp.Transform()))
}
这个选项做了三件事：
- 把
proto.Message类型自动展开为 map-like 表示，再递归比较 - 对
repeated字段按值排序后比（避免顺序敏感） - 跳过未设置字段（即
proto.IsNil为 true 的字段），符合 protobuf wire 格式语义
注意：protocmp.Transform() 要求你已导入 google.golang.org/protobuf/testing/protocmp，且你的 message 必须实现 proto.Message 接口（新版 google.golang.org/protobuf 默认满足，老版 github.com/golang/protobuf/proto 不支持）。
忽略时间戳、自定义字段或调试时跳过大 payload
Protobuf 消息常嵌套 google.protobuf.Timestamp 或业务自定义字段，它们的 Go 类型是 *timestamp.Timestamp，直接比指针地址肯定失败。这时不能靠 protocmp.Transform() 自动处理，得手动加 comparer。
例如忽略所有 created_at 字段并宽松比较时间戳：
opts := []cmp.Option{
protocmp.Transform(),
cmp.Comparer(func(a, b *timestamppb.Timestamp) bool {
if a == nil && b == nil {
return true
}
if a == nil || b == nil {
return false
}
return a.AsTime().Equal(b.AsTime())
}),
cmpopts.IgnoreFields((*mypb.MyMessage)(nil), "updated_at", "id"),
}
几个易踩的坑：
-
cmpopts.IgnoreFields的第一个参数必须是带星号的类型字面量，如(*mypb.MyMessage)(nil)，写成myPb.MyMessage{}会编译失败 - 如果想忽略整个嵌套子消息（比如
details字段），用cmpopts.IgnoreUnexported(mypb.Details{})，而不是字段名 - 大 payload（如
bytes字段）在cmp.Diff中会打出完整 hex，建议用cmpopts.IgnoreBytes或提前截断
对比前先 Normalize，比完再验证是否合法
Protobuf 允许同一语义用多种 wire 表示（如 packed vs unpacked repeated、不同字段编号顺序），protocmp.Transform() 虽能处理大部分情况，但遇到 hand-written 或跨版本生成的 message 仍可能漏比。最稳的方式是先 normalize 再比：
- 调用
proto.Marshal→proto.Unmarshal强制标准化编码 - 或用
proto.Equal（protobuf 官方自带）做快速初筛，再用cmp.Diff定位差异点
另外别忘了：protocmp.Transform() 不校验 message 是否有效（比如违反 required 字段约束）。如果测试场景需要验证合法性，得额外加 proto.Validate 或手动检查 proto.CheckInitialized。
真正容易被忽略的是：当你在测试中 mock 一个 protobuf message 并手动构造字段时，很容易漏掉 XXX_XXX 系列字段的初始化，导致 protocmp.Transform() 在展开过程中 panic。这种时候，宁可少用 transform，改用 proto.Equal + 手动 diff 字段，也比让测试随机挂掉强。
