Go无法直接mock结构体方法,因不支持运行时方法替换;应依赖接口抽象外部依赖,手写mock类型控制返回值与调用状态,并注意nil检查和接口实现完整性。

为什么不能直接 mock 结构体方法
Go 没有内置的 mock 框架,也不支持对任意类型的方法打桩。你无法对 struct 的方法做运行时替换——go test 里写个 monkey.Patch 或反射改函数指针属于危险操作,不推荐在单元测试中使用。真正可依赖、可维护的方式,是让被测代码**依赖接口**,再用自定义类型实现该接口来模拟行为。
如何设计可测试的接口边界
关键不是“怎么 mock”,而是“在哪切一刀”。把外部依赖(HTTP 客户端、数据库、文件系统、第三方 SDK)抽象成接口,并确保被测函数只接收接口参数,而不是具体类型。
- 避免写
func ProcessUser(db *sql.DB),改成func ProcessUser(store UserStore),其中UserStore是你定义的接口 - 接口方法粒度要合理:太粗(如一个
DoEverything())难 mock;太细(每个字段一个 getter)增加冗余 - 接口定义放在被调用方(即业务逻辑包)里更稳妥,避免实现方包污染接口契约
手写 mock 类型的典型写法
不用第三方库也能清晰表达意图。重点是控制返回值、记录调用状态、支持断言。
type MockUserStore struct {
GetFunc func(id int) (*User, error)
SaveFunc func(*User) error
Calls []string // 可选:记录调用痕迹
}
func (m *MockUserStore) Get(id int) (*User, error) {
m.Calls = append(m.Calls, "Get")
return m.GetFunc(id)
}
func (m *MockUserStore) Save(u *User) error {
m.Calls = append(m.Calls, "Save")
return m.SaveFunc(u)
}
测试中按需赋值闭包:
立即学习“go语言免费学习笔记(深入)”;
mock := &MockUserStore{
GetFunc: func(id int) (*User, error) {
return &User{ID: id, Name: "test"}, nil
},
SaveFunc: func(u *User) error {
if u.Name == "" {
return errors.New("name required")
}
return nil
},
}
err := ProcessUser(mock)
// 后续可 assert mock.Calls 或检查 err
容易忽略的坑:接口零值与 panic 风险
如果被测代码没做 nil 检查,而你传了 nil 接口变量,会直接 panic。这不是 mock 的问题,是接口契约没对齐。
- 永远假设接口参数可能为
nil,并在函数开头加if store == nil { panic("store is nil") }或返回错误 - 不要依赖 “接口变量非空就一定有合法实现” —— 手写 mock 时漏实现某个方法,调用就会 panic
- 用
go vet或staticcheck能发现未实现接口的方法,但不会检查 mock 是否覆盖全部路径
真正难的不是写出 mock,而是让接口定义足够稳定、覆盖所有分支、且和真实实现保持行为一致。一旦接口改了,所有 mock 和真实实现都要同步更新。










