go单元测试中必须用接口而非直接mock结构体，因go无运行时方法替换机制，所有mock依赖编译期可替换性；正确做法是让被测代码依赖接口（如userrepository），再通过依赖注入传入实现该接口的mock结构体。
Go 单元测试中 mock 接口方法为什么必须用接口，不能直接 mock 结构体
Go 没有运行时反射式 mock（如 Java 的 Mockito），所有 mock 都基于「编译期可替换」——也就是依赖注入 + 接口抽象。如果你的业务逻辑直接调用了 *UserService 结构体的方法，那根本没法在测试里替换成 mock 实现。
正确做法是：让被测代码只依赖接口，比如 UserRepository 接口，然后在测试时传入一个实现了该接口的 mock 结构体。
- 错误写法：
func (s *Service) GetUser(id int) (*User, error) { return s.repo.GetUserByID(id) }，其中s.repo是*UserRepoImpl结构体指针 → 无法 mock - 正确写法：
s.repo类型是UserRepository接口，而UserRepository定义了GetUserByID(id int) (*User, error) - 测试时构造一个
mockRepo := &MockUserRepository{...}，它实现了UserRepository，再传给Service初始化
gomock 生成的 mock 代码报错 “undefined: mockgen” 或 “cannot use mockRepo (type *mocks.MockUserRepository) as type UserRepository”
这类错误基本都源于类型不匹配或工具链没配对。常见原因和解法如下：
-
mockgen未安装：运行go install github.com/golang/mock/mockgen@latest，确认$GOPATH/bin在$PATH中 - 生成命令路径错：要 mock 接口定义所在包，不是被测业务包。例如接口在
internal/repo，就应执行mockgen -source=internal/repo/user.go -destination=mocks/mock_user.go - 接口没导出：确保你要 mock 的接口名首字母大写（如
UserRepository），且方法也导出（GetUserByID而非getUserByID） - 导入路径不一致：检查测试文件中 import 的 mock 包路径是否与
mockgen生成时指定的-package一致，默认是mocks，但若用了-package=mockrepo，测试里就得import "your/module/mocks"
不用 gomock，手写 mock 时如何控制返回值和调用次数验证
手写 mock 更轻量、更可控，尤其适合简单接口或快速验证逻辑。关键在于把「行为」变成可配置的字段，把「调用记录」存下来供断言。
示例：mock 一个 SendEmail(to, subject, body string) error 方法：
type MockEmailSender struct {
SendFunc func(to, subject, body string) error
CallCount int
LastArgs []string // 存 to/subject/body
ReturnError error
}
func (m *MockEmailSender) SendEmail(to, subject, body string) error {
m.CallCount++
m.LastArgs = []string{to, subject, body}
return m.ReturnError
}
- 控制返回值：初始化时设
mock.ReturnError = errors.New("network timeout") - 验证调用次数：
if mock.CallCount != 1 { t.Fatal("expected 1 call") } - 验证参数：
if mock.LastArgs[0] != "test@example.com" { ... } - 注意：如果被测逻辑并发调用该方法，需加
sync.Mutex保护CallCount和LastArgs
HTTP handler 测试中 mock 依赖服务，为什么 httptest.NewRequest 里传了 body 却收不到
常见原因是没设置 Content-Type 头，或者 handler 里用了 json.Decode(r.Body) 但没 rewind Body（因为 httptest.NewRequest 默认的 Body 是一次性读取流）。
- 必须显式设置头：
req.Header.Set("Content-Type", "application/json") - 如果 handler 内部多次读 Body（比如先校验 token 再解析 JSON），需用
httptest.NewRecorder()配合bytes.NewReader构造可重放 Body - 更稳妥写法：
body := strings.NewReader(`{"id":123}`); req := httptest.NewRequest("POST", "/user", body)，并确保 handler 没提前调用r.Body.Close()或误用ioutil.ReadAll后未重置 - mock 服务依赖建议用接口注入，不要在 handler 里 new 具体实现；否则测试时无法替换，只能走真实网络或数据库
接口抽象不到位、mock 类型不匹配、Body 读取不可逆——这三处最容易卡住半天。实际项目里，宁可多花十分钟理清依赖流向，也别硬写绕过 mock 的“测试适配层”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
