跨平台开发 / 系统课时

用依赖注入拆开难测代码

用依赖注入拆开难测代码

当业务类直接创建网络客户端、读文件或访问全局单例时,测试会被真实环境绑住:速度慢、结果不稳定,也难覆盖失败分支。本篇把这些副作用移动到接口边界,再通过构造参数注入内存 Fake,让核心业务逻辑可以独立、快速地验证。

学习目标

  • 识别网络、文件和全局单例造成的测试耦合
  • 用构造参数注入把业务逻辑与外部实现分离
  • 使用内存 Fake 验证核心逻辑而不访问真实外部资源

先识别真正难测的依赖

难测通常不是因为方法太长,而是因为业务代码自己决定“去哪里拿数据”。例如在 UserService 内部直接 HttpClient()、读取 File,或调用 AppContainer.instance,都会把测试和网络状态、磁盘内容、进程级共享状态绑定在一起。

重构时先区分两类代码:纯计算可以直接测试;会产生 I/O、读取时钟、随机数或全局状态的部分应该成为边界。依赖注入的目标不是给每个类都加接口,而是让不可控因素从核心逻辑中退出。

把副作用放到边界接口

以查询用户为例,业务层真正需要的是“按 ID 取得用户”,并不需要知道数据来自 HTTP、文件还是缓存。可以先定义 UserGateway,让 UserService 只依赖这个抽象;生产环境注入真实实现,测试环境注入内存实现。

构造参数注入把业务逻辑与外部资源隔离

下面的测试文件把接口、业务类和 Fake 放在一起,便于直接运行。实际项目中通常会把生产代码放进 lib/,测试替身放在 test/。

dart
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);
  });
}

预期结果

text
保存为 test/user_service_test.dart 后,测试文件可被 dart test 发现;执行时不会访问网络、文件或全局单例。

在已经配置 package:test 的 Dart package 根目录运行:

bash
dart test test/user_service_test.dart

预期输出

text
<TIME> +1: All tests passed!

<TIME> 为运行时长,实际值会因机器环境不同而变化。

依赖注入为什么能降低测试成本

测试现在只需要构造一个 FakeUserGateway,就能精确控制“用户存在”“用户不存在”“用户被禁用”等输入。业务类不再负责创建依赖,因此测试既不需要启动 HTTP 服务,也不需要准备临时文件,更不会被其他测试修改过的单例状态污染。

同样的拆法可以用于文件存储、系统时钟、随机数和第三方 SDK。关键判断是:如果某个依赖让测试必须等待外部环境、难以制造边界条件,或会在测试之间共享可变状态,它就值得被注入。

从遗留代码迁移时保持小步

不要一次把整个模块改成复杂的依赖注入框架。更稳妥的顺序是先为最难测的外部调用提取一个窄接口,再给业务类增加构造参数,随后用 Fake 补上核心行为测试,最后才替换剩余的直接访问。

如果一个依赖只是无状态、确定性的纯函数,额外抽象反而会增加阅读成本。依赖注入应当围绕可替换的副作用边界使用,而不是把每个方法都包装成接口。

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

目录与阅读设置

阅读设置

17

记录一个想法

用依赖注入拆开难测代码

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

登录哪都通