Gomock 只能 mock 接口，不能直接 mock 结构体方法，因为 Go 类型系统要求被 mock 的类型必须是接口才能被实现和替换；需先提取行为为导出接口，再依赖接口而非具体 struct。
为什么 Gomock 不能直接 mock 结构体方法
Gomock 只能 mock 接口，不能 mock 结构体或其方法。如果你试图对一个 struct 直接生成 mock，mockgen 会报错或静默失败——因为 Go 的类型系统里，只有接口才能被实现、被替换。常见错误是定义了一个 struct 并希望“打桩它的某个方法”，结果发现 mockgen 什么都没生成，或者测试里调用的仍是原实现。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先提取出被依赖的服务行为为 interface，比如
UserService、OrderRepository - 确保业务代码依赖的是该 interface，而非具体 struct（即遵循依赖倒置）
- 检查 interface 是否导出：非导出方法（小写开头）不会被
mockgen扫描到 - 避免在 interface 中定义空方法或仅用于文档的占位方法，
mockgen会为每个方法生成对应 mock 方法，冗余增加维护成本
如何用 mockgen 自动生成 mock 文件并正确引入
mockgen 是 Gomock 的代码生成工具，不手写 mock 类型是基本要求。但很多人卡在路径和包名上：生成的 mock 文件无法 import，或测试中提示 “undefined: NewMockXXX”。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 使用反射模式生成（推荐初学者）：
mockgen -source=service.go -destination=mocks/mock_user_service.go -package=mocks - 注意
-package必须与目标文件所在目录一致；若mocks/下已有go.mod或非空go文件，需确保其package mocks - 生成后，在测试文件中 import 对应路径，例如：
"your-project/mocks"，而不是相对路径或错误子模块名 - 如果源 interface 在
internal/下，mockgen默认无法访问——改用-exec_only+ 显式-imports，或把 interface 提到pkg/等可导出位置
在 Gin/Hertz 微服务测试中如何注入 mock 实例
微服务通常通过依赖注入（如 wire、dig）或构造函数传参组装 handler 和 service。直接在测试里 new 一个 handler，却没替换掉它内部持有的 repository 实例，mock 就完全不起作用。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 不要在 handler 初始化时硬编码 new 具体 service，而是接收 interface 参数，例如：
func NewUserHandler(us UserService) *UserHandler - 测试中构造 mock 控制器：
ctrl := gomock.NewController(t)，再创建 mock 实例：mockSvc := mocks.NewMockUserService(ctrl) - 把
mockSvc注入 handler，再用httptest.NewServer或直接调用 handler 方法（如handler.CreateUser） - 务必 defer
ctrl.Finish()，否则未验证的期望会 panic，且错误信息只显示 “Expected call at …” 而不说明哪条 expectation 没命中
Expectation 写法常见错误与 timeout 处理
最常踩的坑是 expectation 与实际调用不匹配：参数类型不对、指针 vs 值、多次调用没声明 .AnyTimes() 或 .Times(n)，导致测试 panic 或静默跳过。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
gomock.Any()要谨慎：它绕过类型检查，容易掩盖参数逻辑错误；优先用具体值或gomega配合gomock.AssignableToTypeOf - 涉及 struct 参数时，用
gomock.Eq(&expected)或gomock.AssignableToTypeOf(&MyStruct{})，避免因字段顺序或未导出字段导致匹配失败 - HTTP handler 测试中，若被测方法异步调用下游（如 goroutine 发请求），需用
time.Sleep或sync.WaitGroup等待，否则ctrl.Finish()会在 mock 调用前执行，报 “no expected call” - 不要在 expectation 中做耗时操作（如数据库查询、网络请求），mock 的职责只是返回预设响应，真实副作用必须剥离
interface 定义粒度、mock 初始化时机、expectation 与实际调用的严格对齐——这三处稍有偏差，测试就从“验证行为”退化成“假装跑过了”。
