跨平台开发 / 系统课时
用依赖注入拆开难测代码
用依赖注入拆开难测代码
当业务类直接创建网络客户端、读文件或访问全局单例时,测试会被真实环境绑住:速度慢、结果不稳定,也难覆盖失败分支。本篇把这些副作用移动到接口边界,再通过构造参数注入内存 Fake,让核心业务逻辑可以独立、快速地验证。
学习目标
- 识别网络、文件和全局单例造成的测试耦合
- 用构造参数注入把业务逻辑与外部实现分离
- 使用内存 Fake 验证核心逻辑而不访问真实外部资源
先识别真正难测的依赖
难测通常不是因为方法太长,而是因为业务代码自己决定“去哪里拿数据”。例如在 UserService 内部直接 HttpClient()、读取 File,或调用 AppContainer.instance,都会把测试和网络状态、磁盘内容、进程级共享状态绑定在一起。
重构时先区分两类代码:纯计算可以直接测试;会产生 I/O、读取时钟、随机数或全局状态的部分应该成为边界。依赖注入的目标不是给每个类都加接口,而是让不可控因素从核心逻辑中退出。
把副作用放到边界接口
以查询用户为例,业务层真正需要的是“按 ID 取得用户”,并不需要知道数据来自 HTTP、文件还是缓存。可以先定义 UserGateway,让 UserService 只依赖这个抽象;生产环境注入真实实现,测试环境注入内存实现。

下面的测试文件把接口、业务类和 Fake 放在一起,便于直接运行。实际项目中通常会把生产代码放进 lib/,测试替身放在 test/。
import 'package:test/test.dart';
class User {
final String id;
final bool active;
const User(this.id, this.active);
}
abstract interface class UserGateway {
Future<User?> findById(String id);
}
class UserService {
final UserGateway gateway;
UserService(this.gateway);
Future<bool> canLogin(String id) async {
final user = await gateway.findById(id);
return user != null && user.active;
}
}
class FakeUserGateway implements UserGateway {
final Map<String, User> users;
FakeUserGateway(this.users);
@override
Future<User?> findById(String id) async => users[id];
}
void main() {
test('active user can login without real I/O', () async {
final gateway = FakeUserGateway({
'u-1': const User('u-1', true),
});
final service = UserService(gateway);
expect(await service.canLogin('u-1'), isTrue);
expect(await service.canLogin('missing'), isFalse);
});
}预期结果
保存为 test/user_service_test.dart 后,测试文件可被 dart test 发现;执行时不会访问网络、文件或全局单例。在已经配置 package:test 的 Dart package 根目录运行:
dart test test/user_service_test.dart预期输出
<TIME> +1: All tests passed!<TIME> 为运行时长,实际值会因机器环境不同而变化。
依赖注入为什么能降低测试成本
测试现在只需要构造一个 FakeUserGateway,就能精确控制“用户存在”“用户不存在”“用户被禁用”等输入。业务类不再负责创建依赖,因此测试既不需要启动 HTTP 服务,也不需要准备临时文件,更不会被其他测试修改过的单例状态污染。
同样的拆法可以用于文件存储、系统时钟、随机数和第三方 SDK。关键判断是:如果某个依赖让测试必须等待外部环境、难以制造边界条件,或会在测试之间共享可变状态,它就值得被注入。
从遗留代码迁移时保持小步
不要一次把整个模块改成复杂的依赖注入框架。更稳妥的顺序是先为最难测的外部调用提取一个窄接口,再给业务类增加构造参数,随后用 Fake 补上核心行为测试,最后才替换剩余的直接访问。
如果一个依赖只是无状态、确定性的纯函数,额外抽象反而会增加阅读成本。依赖注入应当围绕可替换的副作用边界使用,而不是把每个方法都包装成接口。