本文讲解如何通过定义统一接口来解耦真实依赖与模拟对象，避免因直接使用具体类型（如 *datastore.storage）导致的类型不兼容错误，从而让 eventhandler 等函数可被可靠地单元测试。
本文讲解如何通过定义统一接口来解耦真实依赖与模拟对象，避免因直接使用具体类型（如 *datastore.storage）导致的类型不兼容错误，从而让 eventhandler 等函数可被可靠地单元测试。
在 Go 的单元测试中，Mocking 是验证业务逻辑与外部依赖（如数据存储）交互行为的关键手段。但初学者常遇到如下典型错误：
cannot use s (type *MockStore) as type *datastore.Storage in argument to EventHandler
该错误的根本原因在于：Go 是强类型语言，且不支持隐式类型转换；*MockStore 与 *datastore.Storage 是两个完全无关的指针类型，即使二者方法签名相似，也无法直接互换。
✅ 正确解法是引入接口抽象层——这正是 Go “组合优于继承” 和 “依赖于抽象而非实现” 哲学的核心实践。
1. 定义通用接口
首先，提取 datastore.Storage 的关键行为（如 Get/Set），定义一个简洁、专注的接口：
type Store interface {
Get(key string) (interface{}, error)
Set(key string, value interface{}) error
}⚠️ 注意：接口应聚焦测试所需行为，避免过度设计；方法签名需与真实 datastore.Storage 兼容（或通过适配器桥接）。
2. 让真实类型和 Mock 类型共同实现该接口
- datastore.Storage 通常已实现相关方法，只需确认其满足 Store 接口（无需显式声明，Go 支持结构体自动满足接口）；
- MockStore 显式实现接口方法，并集成 testify/mock 行为：
type MockStore struct {
mock.Mock
}
func (m *MockStore) Get(key string) (interface{}, error) {
args := m.Called(key)
return args.Get(0), args.Error(1)
}
func (m *MockStore) Set(key string, value interface{}) error {
args := m.Called(key, value)
return args.Error(0)
}3. 修改 Handler 依赖为接口类型（非指针！）
关键修正：*函数参数应接收接口值 Store，而非 `Store` 或具体类型指针**：
func EventHandler(w http.ResponseWriter, r *http.Request, bucket Store) {
// ✅ 现在可传入 *MockStore 或 datastore.Storage 实例
data, err := bucket.Get("user:123")
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
// ... 处理逻辑
}? 重要原则：Go 中接口本身是引用类型，传递接口值即可高效传递底层数据；传 *Store 是常见误区——接口指针几乎从不必要，且会破坏多态性。
4. 测试中安全注入 Mock
在测试中，创建 *MockStore 实例并传入 Handler：
func TestEventHandler(t *testing.T) {
w := httptest.NewRecorder()
r := httptest.NewRequest("GET", "/api/user", nil)
mockStore := new(MockStore)
mockStore.On("Get", "user:123").Return(map[string]string{"name": "Alice"}, nil)
EventHandler(w, r, mockStore) // ✅ 类型匹配：*MockStore 满足 Store 接口
assert.Equal(t, http.StatusOK, w.Code)
mockStore.AssertExpectations(t)
}总结与最佳实践
- ? 永远依赖接口，而非具体类型：这是 Go Mocking 可行的前提；
- ? 避免在函数参数中使用 *Interface —— 接口值本身已具备引用语义；
- ? 若无法修改 datastore.Storage 的源码，可编写适配器包装其实例，使其满足 Store 接口；
- ? testify/mock 的 Called() 和 Return() 应严格匹配方法签名顺序与数量；
- ? 在大型项目中，建议将 Store 接口置于独立包（如 internal/storage），增强可维护性与复用性。
遵循以上模式，你将彻底摆脱类型碰撞困扰，构建出高内聚、易测试、松耦合的 Go 服务代码。
