跨平台开发 / 系统课时
覆盖 Provider 替换真实依赖
覆盖 Provider 替换真实依赖
测试 Riverpod 状态逻辑时,通常不希望真正访问网络、数据库或文件系统。本篇介绍如何使用 Provider overrides 在测试环境中替换 Repository,实现业务逻辑与外部依赖隔离,并验证状态变化是否来自正确的数据源。
学习目标
- 理解 Provider overrides 在测试中的作用和适用场景。
- 学会使用 ProviderContainer 覆盖 Repository 依赖。
- 掌握通过假数据验证状态逻辑的方法。
为什么测试时需要替换依赖
实际应用中,Notifier 往往依赖 Repository 获取数据。例如订单列表可能来自 HTTP 接口,用户信息可能来自数据库。如果测试时直接调用真实实现,会引入网络波动、环境配置和数据准备问题。
覆盖 Provider 的核心思想是保持业务代码不变,只在测试环境中替换依赖来源。Notifier 仍然调用同一个 Provider,但 Provider 返回的对象已经变成测试专用实现。
使用 overrides 注入测试 Repository
Riverpod 可以通过 ProviderContainer 的 overrides 参数完成替换。下面示例使用一个用户 Repository,测试时注入内存数据。
dart
import 'package:flutter_riverpod/flutter_riverpod.dart';
final userRepositoryProvider = Provider<UserRepository>((ref) {
return ApiUserRepository();
});
abstract class UserRepository {
List<String> fetchUsers();
}
class ApiUserRepository implements UserRepository {
@override
List<String> fetchUsers() {
return ['server-user'];
}
}
class FakeUserRepository implements UserRepository {
@override
List<String> fetchUsers() {
// 测试数据固定,避免依赖外部系统。
return ['alice', 'bob'];
}
}
void main() {
final container = ProviderContainer(
overrides: [
userRepositoryProvider.overrideWithValue(FakeUserRepository()),
],
);
final repository = container.read(userRepositoryProvider);
print(repository.fetchUsers());
container.dispose();
}预期输出
text
[alice, bob]测试容器读取 userRepositoryProvider 时,实际获得的是 FakeUserRepository,而不是默认的 ApiUserRepository。
Provider 覆盖的常见场景
| 场景 | 覆盖方式 | 目的 |
|---|---|---|
| 网络请求 | 替换 API Repository | 返回固定响应 |
| 数据库访问 | 替换 Storage Provider | 避免真实读写 |
| 时间相关逻辑 | 替换 Clock Provider | 固定测试时间 |
| 用户权限 | 替换 Auth Provider | 模拟不同角色 |
覆盖依赖时,应优先替换外部边界,而不是替换被测试的 Notifier 本身。这样测试仍然能够验证业务流程是否正确。
使用 overrides 时的边界
Provider 覆盖适合测试依赖注入关系,但不应该把所有逻辑都放入 Fake 类中。Fake 的职责是提供稳定输入,业务判断仍应由真实 Notifier 执行。
当测试目标是验证 Repository 自身实现时,应使用其他测试方式;当目标是验证状态变化时,覆盖 Repository 是更合适的选择。
按自己的节奏,确认真正理解。