跨平台开发 / 系统课时
通过构造参数注入外部依赖
通过构造参数注入外部依赖
业务对象如果在内部直接创建网络客户端、数据库或时间源,单元测试就会被真实环境牵制。构造参数注入把这些外部能力移到对象之外,使生产实现和测试实现可以通过同一接口替换。
学习目标
- 理解直接创建外部依赖为什么会降低单元测试的稳定性
- 能通过构造参数把业务逻辑与外部实现解耦
- 能使用轻量 Fake 验证业务结果和依赖调用
把依赖创建移出业务对象
假设 UserService 需要从远程服务读取用户名。如果它在方法内部直接创建 HTTP 客户端,那么测试 greeting 时就不得不面对网络连接、服务地址、认证信息和远端数据状态。真正想验证的字符串拼接逻辑反而被大量无关条件包围。
更合适的边界是让业务对象只依赖一个描述所需能力的抽象,再由外部代码决定传入真实实现还是测试实现。

构造注入还有一个直接收益:依赖关系会出现在构造函数签名中。创建 UserService 的代码必须明确提供 UserGateway,因此对象需要什么能力一目了然,不会隐藏在某个方法里的 new 调用中。
用接口和构造函数建立替换点
下面的测试文件定义了接口、业务对象和一个 Fake。Fake 不访问网络,只返回测试指定的数据,同时记录收到的用户 ID,从而验证业务对象是否正确调用了依赖。
import 'package:test/test.dart';
abstract class UserGateway {
Future<String> loadDisplayName(String userId);
}
class UserService {
UserService(this._gateway);
// 业务对象只认识抽象,不负责创建具体网络实现。
final UserGateway _gateway;
Future<String> greeting(String userId) async {
final name = await _gateway.loadDisplayName(userId);
return 'Hello, $name';
}
}
class FakeUserGateway implements UserGateway {
FakeUserGateway(this.name);
final String name;
String? requestedUserId;
@override
Future<String> loadDisplayName(String userId) async {
// Fake 同时提供可控结果并记录协作参数。
requestedUserId = userId;
return name;
}
}
void main() {
test('greeting uses injected gateway', () async {
final gateway = FakeUserGateway('Ada');
final service = UserService(gateway);
final result = await service.greeting('u-42');
expect(result, 'Hello, Ada');
expect(gateway.requestedUserId, 'u-42');
});
}将文件保存为 test/user_service_test.dart 后运行 dart test test/user_service_test.dart。预期输出末尾类似下面内容,其中 <TIME> 会随运行环境变化:
<TIME> +1: All tests passed!这个测试没有启动服务器,也没有请求真实接口。UserService 的行为由输入和 Fake 的返回值完全控制,因此失败时可以优先检查业务逻辑,而不是先排查网络环境。
接口应该围绕业务需要设计
为了测试而给每个类都创建接口会增加无意义的抽象。真正值得隔离的通常是具有副作用、速度慢或结果不稳定的边界,例如网络请求、数据库、文件系统、系统时间和随机数。
接口也不必照搬第三方库的全部 API。UserService 只需要“根据用户 ID 获取显示名”,因此 UserGateway 只暴露这一项能力。接口越贴近业务需要,Fake 越容易编写,测试也越不容易因为底层 SDK 更换而大面积修改。
网络、存储和时间都可以采用同一思路
网络依赖可以注入 Gateway 或 API Client,存储依赖可以注入 Repository 或 Key-Value Store,时间依赖则可以注入时钟对象或返回当前时间的函数。共同原则是:业务对象负责使用能力,外部组装代码负责选择具体实现。
构造参数注入尤其适合“对象生命周期内依赖不会变化”的场景。它让生产代码显式表达依赖,让测试可以传入可控实现,并把真实网络、磁盘和系统时钟留在单元测试边界之外。