必须先抽象接口再生成Mock,否则自测无法运行;Go依赖接口契约mock,mockgen需覆盖多文件、嵌入接口和internal目录;分支逻辑用DoAndReturn而非Return;调用次数应按场景设MinTimes或AnyTimes而非硬写Times(1)。

必须先抽象接口,再生成 Mock,否则自测流程根本跑不起来。 Go 没有运行时反射打桩能力,所有 Mock 都依赖“接口即契约”这一前提——你不能 mock 一个 struct、一个具体实现,只能 mock 一个 interface。漏掉这步,后面所有 EXPECT、DoAndReturn 都是空谈。
mockgen 生成的文件没覆盖全部方法?检查这三个地方
很多人执行完 mockgen -source=service.go 就以为万事大吉,结果测试跑一半 panic:method not expected。常见原因:
- 接口定义分散在多个文件里,
mockgen只扫描了指定文件,其他文件里的方法没被识别 - 用了嵌入接口(如
type Service interface { Reader; Writer }),mockgen默认不展开嵌入项,生成的 Mock 缺少Read()和Write()的 EXPECT 入口 - 接口放在
internal/目录下,mockgen默认跳过,需显式加-build_flags="-tags=unit"
验证方式:打开生成的 mock_service.go,逐行确认每个接口方法是否都有对应的 EXPECT().MethodName() 调用入口。没有?就说明没扫到,得调参数或改路径。
分支逻辑总测不全?别只用 Return(),改用 DoAndReturn()
Return() 返回固定值,但真实业务常按输入走不同路径。比如 GetUser(id int) 有三路分支:id 、id > 1000 → 从缓存取、其余 → 查 DB。单靠 Return(&User{}, nil) 只能覆盖最后一支。
换成 DoAndReturn() 才能一次覆盖多分支:
mockUser.EXPECT().GetUser(gomock.Any()).DoAndReturn(func(id int) (*User, error) {
if id 1000 {
return &User{ID: id, FromCache: true}, nil
}
return &User{ID: id}, nil
})
注意:里面只做简单条件映射,别塞业务逻辑;否则测试变黑盒,下次自己都看不懂。
测试失败报 “Expected call at … but didn’t happen”?大概率是调用次数设错了
硬写 Times(1) 是最常见陷阱。真实流程中,DB 查询可能因缓存命中而调用 0 次,重试逻辑可能调 2 次,分页拉取可能 N 次。一写死就卡死。
- 对日志、指标等非关键路径,直接用
AnyTimes()放行 - 对必须发生的主干调用(如订单写入 DB),用
MinTimes(1),允许重试成功后多调一次 - 只有极少数确定只调一次且不允许重试的场景,才用
Times(1)
另外,gomock.InOrder() 在涉及串行依赖的流程里很关键——比如“先查库存 → 再扣减 → 最后创建订单”,顺序错乱会导致状态不一致,但错误信息不会明说,只会报某次 EXPECT 没触发。
真正难的不是写 Mock,而是把业务流程里每条分支、每个调用时机、每个状态跃迁都映射成可验证的期望行为。接口没抽象好、mockgen 没扫全、DoAndReturn 里条件写漏、调用次数卡太死——任一环节松动,自测就变成“看起来过了,其实漏了”。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











