Go接口mock必须基于interface，由mockgen自动生成，且用gomock.Controller管理生命周期；mock仅作用于interface因其需生成实现该接口的新struct以支持依赖注入。
Go 接口 mock 的核心是：**必须基于 interface，不能直接 mock struct 或函数；mock 代码需由 mockgen 自动生成，不可手写；且必须用 gomock.Controller 管理生命周期和调用验证。** 手动伪造、漏掉 defer ctrl.Finish()、或试图 mock 非接口类型，是 90% 失败的根源。
为什么 mock 只能作用于 interface？
Go 的 mock 机制本质是「编译期生成一个新 struct，实现目标 interface 的所有方法」。这个 struct 内部维护调用记录、返回值规则、匹配逻辑等——它必须能被赋值给原 interface 类型变量，否则测试时无法注入。如果业务代码直接依赖 *UserDB 或 http.Client 这类具体类型，就无法被 GoMock 替换。
- ✅ 正确做法：提前抽象出
type UserRepository interface { GetByID(id string) (*User, error) }，所有业务逻辑依赖该 interface - ❌ 常见错误：测试时发现
mockgen -source=user_db.go报错 “no interfaces found”，因为文件里只有 struct 和方法，没定义 interface - ⚠️ 注意：标准库如
net/http的Client本身不是 interface，但你可以包装一层，比如type HTTPDoer interface { Do(*http.Request) (*http.Response, error) }
mockgen 两种模式怎么选？
选源码模式（-source）还是反射模式（import_path InterfaceName），取决于你的接口是否已导出、是否跨包、以及 CI 是否可控。
-
-source=user.go：适合接口和实现都在同一包，且user.go中有exportedinterface 定义；简单直接，推荐新手起步 -
github.com/yourorg/pkg UserStore：适合接口定义在其他包（如pkg/userstore.go），且你不想把整个包复制进测试目录；但要求该包可go build，否则反射失败 - ⚠️ 坑点：
mockgen不识别未导出（小写开头）的 interface；若报 “interface not found”，先检查大小写和export状态 - ? 提示：在接口文件顶部加
//go:generate mockgen -destination=mock_userstore.go -package=userstore_test github.com/yourorg/pkg UserStore，后续只需go generate ./...
测试中 EXPECT() 和 Return() 怎么写才不翻车？
EXPECT() 不是断言，而是“声明我预期这个方法会被这样调用一次”；漏写、多写、参数不匹配都会导致 ctrl.Finish() panic。
- 基础写法：
mockRepo.EXPECT().GetByID("123").Return(&User{Name: "Alice"}, nil) - 参数灵活匹配：
mockRepo.EXPECT().GetByID(gomock.Eq("123")).Return(...)（Eq比Any更安全，避免误匹配） - 多次调用不同返回：
mockRepo.EXPECT().GetByID("123").Return(u1, nil).Times(1)，再写一行.EXPECT().GetByID("456").Return(u2, nil) - ⚠️ 致命错误：忘记
defer ctrl.Finish()→ 测试通过但实际没验证调用；或调用次数超预期 → panic 提示 “expected call at … never called” - ? 调试技巧：运行测试加
-v参数，会打印每条EXPECT的注册和匹配状态
mock 服务 vs. 接口 mock：别混用场景
如果你要模拟的是「前端发 HTTP 请求到后端 API」，那应该用独立的 HTTP Mock 服务（如基于 net/http + YAML 规则的本地 server），而不是 GoMock。GoMock 是给 Go 单元测试用的，只在进程内生效，不启动端口、不处理真实 HTTP。
- ✅ GoMock 适用：测试
UserUsecase调用UserRepository时的逻辑分支、错误传播、并发行为 - ✅ HTTP Mock 服务适用：前端连本地
http://localhost:8080/api/users，根据 query 参数id=999返回 500 错误响应 - ⚠️ 混用后果：用 GoMock 去“拦截外部 HTTP 请求”——不可能，GoMock 没能力 hook
http.DefaultClient的底层 socket；必须靠 interface 抽象 + 依赖注入
最常被忽略的一点：mock 代码不是“写一次就完事”。只要接口签名变了（增删方法、改参数类型、加 context），就必须重新运行 mockgen，否则测试会编译失败或静默跳过验证。把它当成和 go.mod 一样的契约文件来对待。
