Golang测试中使用接口实现mock的思路

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)
}

测试中按需赋值闭包：

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 和真实实现都要同步更新。