跨平台开发 / 系统课时
用 mock 替换外部依赖
用 mock 替换外部依赖
本篇解决业务逻辑测试中网络、数据库等外部依赖不可控的问题,通过 mock 隔离真实资源,让测试可以稳定重复执行,并验证业务代码是否正确处理依赖返回值。
学习目标
- 理解为什么单元测试需要替换外部依赖
- 使用 mock 模拟 Repository 等外部服务行为
- 编写可验证成功和失败分支的 Flutter 单元测试
为什么单元测试需要 mock
单元测试关注的是当前代码的业务逻辑,而不是网络连接、数据库状态或第三方服务是否可用。如果测试直接调用真实依赖,测试结果会受到环境、网络和数据状态影响。
例如,一个登录业务类依赖用户接口。如果每次测试都请求真实服务器,那么接口延迟、服务异常或者测试账号变化都会导致测试不稳定。mock 的作用就是提供一个可控的替代对象,让测试只关注业务判断。
在 Flutter 项目中,通常会 mock Repository、数据源、客户端或系统服务,而不是 mock 被测试的业务类。
使用 mockito 替换 Repository
Flutter 中常用 mockito 创建模拟对象。下面示例测试一个依赖用户仓库的登录服务。
dart
import 'package:flutter_test/flutter_test.dart';
import 'package:mockito/mockito.dart';
class User {
final String name;
User(this.name);
}
abstract class UserRepository {
Future<User> fetchUser();
}
class MockUserRepository extends Mock implements UserRepository {}
class UserService {
final UserRepository repository;
UserService(this.repository);
Future<String> loadUserName() async {
final user = await repository.fetchUser();
return user.name;
}
}
void main() {
test('returns user name from repository', () async {
final repository = MockUserRepository();
final service = UserService(repository);
// 控制外部依赖返回固定数据,避免访问真实数据源
when(repository.fetchUser())
.thenAnswer((_) async => User('Alice'));
final result = await service.loadUserName();
expect(result, 'Alice');
verify(repository.fetchUser()).called(1);
});
}预期输出
text
00:00 +1: returns user name from repository
00:00 +1: All tests passed!测试中 when 定义 mock 行为,verify 检查依赖是否按照预期被调用。这样既验证了业务结果,也确认了依赖交互过程。
mock 的使用边界
mock 并不是越多越好。过度 mock 会让测试只验证调用关系,而无法发现真实协作问题。
适合使用 mock 的场景包括:
- 网络 API 请求
- 本地数据库访问
- 文件系统操作
- 时间、随机数等不可预测资源
不适合 mock 的场景包括:
- 简单的数据模型
- 纯函数计算
- 当前模块内部已经稳定的业务逻辑
一个好的单元测试应该模拟变化来源,而不是模拟所有对象。
设计容易测试的业务代码
如果一个类直接创建 HTTP 客户端或数据库连接,测试时很难替换依赖。更推荐通过构造函数注入依赖。
例如:
dart
class OrderService {
final OrderRepository repository;
OrderService(this.repository);
}业务类只依赖抽象接口,测试时传入 mock,实现代码时传入真实实现。
这种设计可以降低耦合,同时让测试更加稳定。
按自己的节奏,确认真正理解。