GoMock只支持mock接口，必须基于接口抽象和依赖注入；mockgen生成失败或编译报错主因是业务代码未依赖接口、接口未导出或包名不匹配，且需配对使用gomock.Controller与Finish校验。
GoMock 不是“拿来就能 mock 任何函数”的万能工具，它只 mock 接口，且必须基于接口抽象 + 依赖注入才能生效。跳过这一步直接写 mockgen，90% 的失败都源于此。
为什么 mockgen 生成了代码却编译报错或 panic？
常见错误现象：undefined: NewMockUserService、cannot use mockUser (type *mock_user.MockUserService) as type UserService in argument。
根本原因不是工具没装好，而是业务代码没按 GoMock 的契约写：
- 被测逻辑必须依赖
interface，不能直接调用结构体方法或包级函数（如db.QueryRow()或http.Get()） - 接口必须可导出（首字母大写），且定义在能被
mockgen扫描到的位置（通常放在.go文件里，而非_test.go） - mockgen 生成的 mock 类型和原接口不在同一包时，需确保
-package参数与测试文件的包名兼容（例如测试文件是user_test，mock 文件-package=user_test最稳妥） - 改了接口签名后没重跑
mockgen，导致生成代码滞后——这不是 bug，是预期行为
gomock.NewController(t) 和 defer ctrl.Finish() 为什么不能省？
ctrl.Finish() 不只是“收尾”，它是验证环节的核心开关：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 不调用它，所有
EXPECT()设置的调用预期都不会被检查，测试会“静默通过”，哪怕实际根本没调用目标方法 - 它会检查：是否有多余调用（unexpected call）、是否遗漏调用（missing call）、参数是否匹配、顺序是否满足
After()约束 - 如果测试提前 return（比如中间
assert.Fail()），defer仍能保证验证执行，避免漏检 - 每个测试函数必须有独立的
ctrl，跨测试复用会导致状态污染
EXPECT().Method() 后不接 Return() 就 panic？
是的，但原因常被误解。GoMock 要求每个 EXPECT() 必须明确声明返回值或行为，否则运行时 panic 报错类似：panic: missing return value for method "GetUser"。
这不是语法强制，而是设计选择——它迫使你显式表达“这个调用预期产生什么”：
- 正常路径：
mockRepo.EXPECT().GetUser(123).Return(&User{Name: "Alice"}, nil) - 错误路径：
mockRepo.EXPECT().GetUser(456).Return(nil, errors.New("not found")) - 忽略返回值（仅校验调用发生）：
mockRepo.EXPECT().Log("start").Return()（注意空括号） - 动态行为：
mockRepo.EXPECT().Save(gomock.Any()).Do(func(u *User) { u.ID = 999 }).Return(nil)
漏写 .Return() 是新手最高频的 panic 来源，IDE 也难提示，只能靠习惯性补全。
mockgen 生成的代码太重，真有必要用吗？
没必要。多数内部接口（如 UserRepository、Notifier）手写 fake 更快、更可控：
- fake 只实现你真正调用的 1–2 个方法，不用管接口里其他 8 个未使用的函数
- 字段可导出（如
Called bool、LastID int），测试中直接assert.True(t, fake.Called)，不依赖黑盒验证逻辑 - 并发安全？嵌入
sync.Mutex，加锁读写字段即可，比学Times(3)和AnyTimes()直观得多 - gomock 的价值场景很窄：mock 外部 SDK（如
cloud.google.com/go/storage.Client）或接口方法 >10 个且需严格顺序/次数校验
真正容易被忽略的是：**gomock 不解决设计问题，只放大设计缺陷**。如果一个接口总在变、方法语义模糊、职责不单一，那无论用 gomock 还是 fake，测试都会脆弱。先重构接口，再考虑 mock 方式。
