gomock只能mock接口，不能mock结构体或包级函数；因http.Client和sql.DB是具体类型，需先定义HTTPDoer、Querier等接口再mock。
gomock 不能直接模拟第三方库的结构体或包级函数，必须先提取接口；否则编译失败或测试不生效。
为什么 mock *http.Client 或 sql.DB 会失败
Go 的 struct 方法不可被替换，gomock 只能 mock 接口类型。像 *http.Client 和 *sql.DB 是具体类型，不是接口——你没法用 gomock 生成它们的模拟实现。
- 常见错误：直接对
http.Get或db.QueryRow写EXPECT()→ 编译报错“cannot assign to function call” - 正确路径：定义最小接口，例如
HTTPDoer封装Do(*http.Request) (*http.Response, error) - 若第三方库没提供接口（如 Stripe SDK），就自己封装一层：
type PaymentClient interface { Charge(ctx context.Context, params stripe.ChargeParams) (*stripe.Charge, error) }
mockgen 生成 mock 的实际命令和参数差异
生成 mock 代码时，-source 和 -reflect 模式行为不同，选错会导致文件为空或找不到接口。
-
mockgen -source=payment.go -destination=mocks/mock_payment.go -package=mocks：从源文件读取，要求payment.go中只含接口定义（无逻辑） -
mockgen github.com/stripe/stripe-go/v72 v72.Client：用反射模式，需确保 import 路径准确、版本号匹配（v72 不是 v71） - 生成失败常见原因：
go: cannot find module providing package→ 先go mod tidy，再确认模块路径是否带/v72等子路径
测试中注入 mock 并设置期望的典型写法
gomock 的 EXPECT() 必须在调用前声明，且调用顺序、参数、次数都严格校验；漏掉 defer ctrl.Finish() 会导致期望未验证就通过。
立即学习“go语言免费学习笔记（深入）”；
-
mockGateway.EXPECT().Charge(100.0, "4111...").Return("txn_abc", nil)：参数必须完全匹配，浮点数用gomock.Any()更安全 - 要测异常分支：
mockGateway.EXPECT().Charge(gomock.Any(), gomock.Any()).Return("", errors.New("timeout")) - 依赖注入必须显式传入：业务结构体字段类型要是接口（如
gateway PaymentGateway），不能是*stripe.Client - 别在测试里 new 出真实客户端——哪怕只是临时用，也会绕过 mock，导致测试连接真实服务
httptest.Server 和 gomock 的分工边界
gomock 用于 mock 接口抽象层（如支付网关、邮件服务），而 httptest.Server 专用于替换 HTTP 请求目标；混用或误判会导致 mock 失效或测试不稳定。
- 当你 mock 的是「调用外部 API 的封装层」（比如
type WeatherAPI interface { GetForecast(city string) (Weather, error) }），用 gomock - 当你需要验证底层 HTTP 请求内容（headers、body、query）、或第三方 SDK 内部用了
http.DefaultClient且无法替换 client 字段，用httptest.Server并把srv.URL注入到该 SDK 的 base URL 配置中 - 注意：
srv.URL总是http://开头，即使你模拟 HTTPS 接口；SDK 必须支持运行时设置 base URL，否则得改源码或加 wrapper
最容易被忽略的是接口定义粒度——太宽（比如包含 15 个方法）会让 mock 维护成本飙升，太窄（只一个方法）又失去抽象意义。真正的难点不在工具使用，而在决定「这一层该由谁负责抽象」。
