跨平台开发 / 系统课时

覆盖 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 是更合适的选择。

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

目录与阅读设置

阅读设置

17

记录一个想法

覆盖 Provider 替换真实依赖

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

登录哪都通