gomock 生成的 mock 报错 undefined: xxxMock，因 mockgen 默认不导出类型且路径、包名、导入路径不一致；需显式指定 -destination 和 -package，并确保与 import 路径末尾一致。
gomock 生成的 mock 为什么总报错 undefined: xxxMock
因为 mockgen 默认不导出 mock 类型，且生成路径、包名、导入路径三者不一致时，Go 编译器根本找不到类型。常见于用 mockgen -source=xxx.go 但没指定 -destination 和 -package，导致生成文件在错误目录或包名与引用处冲突。
- 务必显式指定
-destination，比如mockgen -source=api.pb.go -destination=mock/api_mock.go -package=mock -
-package值必须和你在测试文件中import的路径末尾一致（如import "yourproj/mock"→-package=mock） - 如果源文件是
.pb.go，注意它通常含多个 service 接口；mockgen默认只 mock 第一个，加-self_package或改用-imports才能正确解析依赖
gRPC 接口 mock 不起作用？检查 grpc.ClientConnInterface 和真实 client 是否对齐
直接 mock pb.NewXXXClient(conn) 返回的 client 没用——它只是个封装，底层调用全走 conn.Invoke()。真正要 mock 的是 grpc.ClientConnInterface，或者更实际点：用 grpc.Dial 的 grpc.WithContextDialer + 内存传输层拦截请求。
- 推荐做法：测试里用
bufconn.Listen(1024 * 1024)启一个内存 listener，再用grpc.Dial("bufnet", grpc.WithContextDialer(...))连过去 - 不要试图 mock
pb.XXXClient的方法——它没实现逻辑，全是透传；mock 它等于 mock 一层壳 - 若坚持用 gomock，只能 mock 你手动定义的 interface（比如把 client 方法抽成
type APIClient interface { GetUser(...) }），而非 pb 自动生成的 client
gomock + gRPC 测试跑得慢？多半卡在 time.Sleep 或未关闭的 conn
gRPC 测试里常见隐式阻塞：未调用 server.Stop()、mock 预期没写全导致 EXPECT() 等超时、或忘记 defer conn.Close()。gomock 本身不慢，慢的是网络等待和资源泄漏。
- 每个测试结束前必须
server.GracefulStop()（不是Stop()）+conn.Close() - 用
gomock.Finish()检查预期是否被满足，否则测试会通过但后续执行卡住 - 避免在测试里用
time.Sleep(100 * time.Millisecond)等待——改用testutil.MustWaitFor或 channel 同步
为什么 mockgen 无法识别 pb 文件里的 service 接口
mockgen 默认只解析 Go 源码中的 interface 定义，而 .pb.go 里 service client 是 struct + method，不是 interface。它不会自动把 type UserServiceClient interface { ... } 当作可 mock 目标，除非你显式告诉它。
立即学习“go语言免费学习笔记（深入）”；
- 加
-source=api.pb.go时，必须确保该文件里有明确的 interface 声明（新版 protoc-gen-go-grpc 默认生成） - 老版本 protobuf（如 v1.28 之前）只生成 struct，此时必须先手写 interface，再让
mockgen -source=your_interface.go - 更稳的方式：用
mockgen -destination=mock/user_mock.go -package=mock yourproj/pb UserServiceClient，直接按名称反射提取
gomock 对 gRPC 的支持本质是“借壳”，它不理解 RPC 语义，只认 Go interface。最容易被忽略的点是：你以为在 mock 一个 client，其实只是 mock 了一个空壳；真正要测通路，得动 conn 层或自己抽象一层 interface。
