Go / 系统课时

通过接口替换外部依赖

通过接口替换外部依赖

这节课把网络、存储等外部依赖收缩成业务真正需要的最小接口,再在测试中注入可记录调用的替身。最终你会得到一个不访问真实库存系统、却能同时验证返回结果和业务交互的稳定单元测试。

学习目标

  • 能从消费方需求出发定义最小接口,避免测试直接连接外部系统。
  • 能编写轻量替身并注入业务对象,记录关键调用参数。
  • 能区分“业务结果正确”和“依赖交互正确”两类断言。

从消费方定义最小接口

业务代码如果直接创建 HTTP 客户端、数据库连接或具体 SDK,单元测试就会被网络、账号、数据状态和响应延迟绑住。更稳妥的做法是让业务层只依赖自己真正需要的行为,例如库存场景只要求“为某个 SKU 预留数量”,而不是暴露整个仓储客户端。

接口应定义在消费方附近,并保持尽量小。这样生产环境可以注入真实实现,测试环境则注入替身;业务代码只认识接口,不需要知道后面究竟是远程服务、数据库还是内存对象。

最小接口隔离外部依赖关系

用替身记录业务交互

下面为了单文件运行把最小业务实现和测试放在一起;实际项目中,Service 与接口应位于普通 .go 文件,替身通常只放在测试代码中。fakeInventory 不模拟真实库存系统的全部行为,只记录 Reserve 的调用。

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

预期结果

text
该测试文件可由 go test 编译;测试通过时会证明 Reserve 只被调用一次,且参数为 sku-42 和 2。

运行测试并验证隔离

在一个空目录中把上面的代码保存为 order_test.go,再创建最小模块文件。整个过程不需要启动库存服务,也不需要准备数据库。

text
module example.com/deps

go 1.22

这个 go.mod 只用于给示例提供固定模块路径,不引入第三方依赖。随后只运行当前测试。

bash
go test -run TestServicePlaceOrder -v

预期输出

text
=== RUN   TestServicePlaceOrder
--- PASS: TestServicePlaceOrder (<TIME>)
PASS
ok      example.com/deps   <TIME>

<TIME> 是动态耗时,实际值会不同。关键验证点是测试通过,而且代码路径只经过 fakeInventory,没有任何网络或存储访问。

让替身保持轻量

替身越接近完整外部系统,维护成本越高,也越容易把单元测试变成另一套脆弱实现。优先记录调用、返回指定错误或返回固定数据;只有当前测试确实依赖某种状态变化时,才增加对应行为。

如果多个测试都需要同一类替身,可以抽取少量构造函数或断言辅助函数,但不要为了“复用”把替身做成复杂框架。最小接口加最小替身的目标,是把失败原因限制在业务逻辑和明确的交互契约内,而不是复制被隔离系统本身。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

通过接口替换外部依赖

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通