必须用接口抽象第三方SDK依赖，因Go无运行时方法替换且静态绑定，直接嵌入重写无效；正确做法是定义业务契约接口，返回自定义类型，并确保mockgen路径、接口名、包名合规，或手写轻量mock。
不能直接 mock 第三方 SDK 的结构体方法，必须先用接口抽象切出依赖边界，再手动或自动生成 mock 实现。
为什么 huandu/facebook.App 不能直接 mock
Go 没有运行时方法替换机制，*facebook.App 是具体类型，不实现你定义的接口——哪怕方法名、签名一样，返回值类型不匹配（比如它返回 *facebook.Session，而你要的是 IFbSession）就会编译失败。强行嵌入再重写方法也无效，因为内部调用仍绑定到原始类型。
- 错误做法：
type MockApp struct { *facebook.App }+ 重写Session()→ 内部largerInt()类调用仍走facebook.App.largeInt() - 根本原因：Go 方法调用是静态绑定，嵌入只提升方法，不劫持接收者内部逻辑
- 后果：测试里看似替换了对象，实际 HTTP 请求照发，无法断言、无法控制返回、无法覆盖错误路径
正确切口：把 SDK 调用封装进接口，且返回值类型可控
不是“包装 SDK”，而是定义业务真正需要的行为契约。例如 Facebook 登录流程真正依赖的，不是 *facebook.App 本身，而是“能根据 code 换取用户信息”这件事。
- 接口定义放在业务包里（如
auth/），不要放在 SDK 包或main包中 - 方法粒度要窄：
ExchangeToken(code string) (*User, error)比DoEverything() error更易 mock 和验证 - 返回类型必须是你自己定义的结构体（如
type User struct { ID string; Name string }），避免直接暴露facebook.User - 不要让接口方法返回未导出字段的 struct 值（如
facebook.User），否则gomock生成的 EXPECT 无法构造返回值
mockgen 生成失败？先检查这三处硬性条件
mockgen 不是智能识别器，它只按规则找接口。90% 的失败都卡在这三点上：
立即学习“go语言免费学习笔记（深入）”；
- 路径必须带
./前缀：mockgen -source=./auth/facebook.go，不能写auth/facebook.go - 接口名必须首字母大写：
FacebookClient✅，facebookClient❌ - 源文件包名不能是
main，且需与go list -f '{{.Name}}' ./auth输出一致（比如输出auth，文件头就得是package auth） - 如果接口含泛型（如
Repo[T any]），mockgenv1.6+ 支持有限，建议拆出非泛型基础接口再生成
手写 mock 比 mockgen 更快的两种场景
当接口简单（≤3 个方法）、或含动态行为（如基于时间生成 token）、或 mockgen 因路径/泛型卡住时，手写更省时间：
- 定义 mock 结构体，内嵌
gomock.TestReporter或仅实现接口方法 - 用字段控制返回值：
type MockFB struct { ReturnUser *User; ReturnErr error }，ExchangeToken直接返回字段值 - 加计数器字段（如
CallCount int）验证调用次数，比.Times(1)更直观、无 panic 风险 - 若需模拟网络延迟或随机失败，直接在方法里
time.Sleep()或if rand.Intn(10) == 0 { return nil, errors.New("timeout") }
复杂点在于：所有被测函数必须显式接收该接口作为参数（而非全局变量或 init 初始化），否则抽象层就形同虚设。容易被忽略的是——SDK 初始化本身（如 facebook.New(...)）也要抽成工厂函数，才能在测试中注入 mock 实例。
