Go / 系统课时
通过接口替换外部依赖
通过接口替换外部依赖
这节课把网络、存储等外部依赖收缩成业务真正需要的最小接口,再在测试中注入可记录调用的替身。最终你会得到一个不访问真实库存系统、却能同时验证返回结果和业务交互的稳定单元测试。
学习目标
- 能从消费方需求出发定义最小接口,避免测试直接连接外部系统。
- 能编写轻量替身并注入业务对象,记录关键调用参数。
- 能区分“业务结果正确”和“依赖交互正确”两类断言。
从消费方定义最小接口
业务代码如果直接创建 HTTP 客户端、数据库连接或具体 SDK,单元测试就会被网络、账号、数据状态和响应延迟绑住。更稳妥的做法是让业务层只依赖自己真正需要的行为,例如库存场景只要求“为某个 SKU 预留数量”,而不是暴露整个仓储客户端。
接口应定义在消费方附近,并保持尽量小。这样生产环境可以注入真实实现,测试环境则注入替身;业务代码只认识接口,不需要知道后面究竟是远程服务、数据库还是内存对象。

用替身记录业务交互
下面为了单文件运行把最小业务实现和测试放在一起;实际项目中,Service 与接口应位于普通 .go 文件,替身通常只放在测试代码中。fakeInventory 不模拟真实库存系统的全部行为,只记录 Reserve 的调用。
package order
import (
"errors"
"testing"
)
type Inventory interface {
Reserve(sku string, qty int) error
}
type Service struct {
inventory Inventory
}
func NewService(inventory Inventory) *Service {
return &Service{inventory: inventory}
}
func (s *Service) PlaceOrder(sku string, qty int) error {
if qty <= 0 {
return errors.New("qty must be positive")
}
return s.inventory.Reserve(sku, qty)
}
type reserveCall struct {
sku string
qty int
}
type fakeInventory struct {
calls []reserveCall
err error
}
func (f *fakeInventory) Reserve(sku string, qty int) error {
// 替身只记录测试关心的交互,不复制真实库存实现。
f.calls = append(f.calls, reserveCall{sku: sku, qty: qty})
return f.err
}
func TestServicePlaceOrder(t *testing.T) {
fake := &fakeInventory{}
service := NewService(fake)
if err := service.PlaceOrder("sku-42", 2); err != nil {
t.Fatalf("PlaceOrder() error = %v", err)
}
if len(fake.calls) != 1 {
t.Fatalf("Reserve() calls = %d, want 1", len(fake.calls))
}
// 同时校验调用次数和业务参数,避免只看返回值而漏掉错误交互。
got := fake.calls[0]
if got.sku != "sku-42" || got.qty != 2 {
t.Fatalf("Reserve() call = %#v, want sku-42 x 2", got)
}
}预期结果
该测试文件可由 go test 编译;测试通过时会证明 Reserve 只被调用一次,且参数为 sku-42 和 2。运行测试并验证隔离
在一个空目录中把上面的代码保存为 order_test.go,再创建最小模块文件。整个过程不需要启动库存服务,也不需要准备数据库。
module example.com/deps
go 1.22这个 go.mod 只用于给示例提供固定模块路径,不引入第三方依赖。随后只运行当前测试。
go test -run TestServicePlaceOrder -v预期输出
=== RUN TestServicePlaceOrder
--- PASS: TestServicePlaceOrder (<TIME>)
PASS
ok example.com/deps <TIME><TIME> 是动态耗时,实际值会不同。关键验证点是测试通过,而且代码路径只经过 fakeInventory,没有任何网络或存储访问。
让替身保持轻量
替身越接近完整外部系统,维护成本越高,也越容易把单元测试变成另一套脆弱实现。优先记录调用、返回指定错误或返回固定数据;只有当前测试确实依赖某种状态变化时,才增加对应行为。
如果多个测试都需要同一类替身,可以抽取少量构造函数或断言辅助函数,但不要为了“复用”把替身做成复杂框架。最小接口加最小替身的目标,是把失败原因限制在业务逻辑和明确的交互契约内,而不是复制被隔离系统本身。