跨平台开发 / 系统课时

避免 Provider 承担过多职责

避免 Provider 承担过多职责

Provider 很容易随着需求增长变成“万能控制器”:既发 HTTP 请求,又读本地缓存,还转换模型、处理业务规则和维护页面状态。这样的代码短期集中,长期却难测试、难复用。本节把这些职责拆回合适的边界,让 Provider 专注于协调状态。

学习目标

  • 识别职责过载 Provider 的典型信号
  • 区分服务、Repository、Provider 与 UI 状态的职责
  • 用依赖注入拆分网络访问、业务操作和状态协调

先识别万能 Provider

如果一个 Provider 同时创建 HTTP 客户端、拼接接口地址、解析 JSON、读写持久化存储、执行领域规则,并直接暴露页面所需状态,它通常已经承担过多职责。

这种设计的主要问题不是文件太长,而是变化原因混在一起:后端接口变化会改它,缓存策略变化会改它,页面交互变化也会改它。测试登录状态时甚至可能被迫初始化真实网络或存储依赖。

更清晰的边界通常是:服务负责外部 I/O,Repository 负责业务数据访问策略,Provider 或 Notifier 负责把操作转换成可观察的 UI 状态,Widget 负责渲染和收集用户输入。

Service、Repository、Provider 与 UI 的职责和依赖方向

用 Provider 连接职责明确的对象

下面的示例把外部请求、仓库调用和 UI 状态拆开。为保持示例可直接理解,AuthApi 用延时模拟网络;实际项目可以在同一位置替换为真实 HTTP 实现,而不需要改动控制器的职责。

dart
import 'package:flutter_riverpod/flutter_riverpod.dart';

class User {
  const User(this.name);
  final String name;
}

class AuthApi {
  Future<User> signIn(String email, String password) async {
    // 这里代表网络边界,真实项目可替换为 HTTP 请求。
    await Future<void>.delayed(const Duration(milliseconds: 100));
    if (email.isEmpty || password.isEmpty) {
      throw ArgumentError('email and password are required');
    }
    return const User('Riverpod User');
  }
}

class AuthRepository {
  AuthRepository(this.api);
  final AuthApi api;

  Future<User> signIn(String email, String password) {
    // Repository 对上层隐藏具体数据来源。
    return api.signIn(email, password);
  }
}

final authApiProvider = Provider<AuthApi>((ref) => AuthApi());

final authRepositoryProvider = Provider<AuthRepository>((ref) {
  return AuthRepository(ref.watch(authApiProvider));
});

final authControllerProvider =
    AsyncNotifierProvider<AuthController, User?>(AuthController.new);

class AuthController extends AsyncNotifier<User?> {
  @override
  Future<User?> build() async => null;

  Future<void> signIn(String email, String password) async {
    state = const AsyncLoading();
    state = await AsyncValue.guard(
      () => ref.read(authRepositoryProvider).signIn(email, password),
    );
  }
}

Future<void> main() async {
  final container = ProviderContainer();
  final subscription = container.listen(
    authControllerProvider,
    (_, next) => print(next),
    fireImmediately: true,
  );

  await container
      .read(authControllerProvider.notifier)
      .signIn('dev@example.com', 'secret');

  subscription.close();
  container.dispose();
}

预期输出

text
AsyncData<User?>(value: null)
AsyncLoading<User?>()
AsyncData<User?>(value: Instance of 'User')

不同 Riverpod 版本的调试字符串格式可能略有差异,但状态顺序应保持为初始数据、加载中、成功数据。示例中的延迟时间也只是模拟网络边界,并不是业务要求。

Provider 应该负责什么

拆分后,AuthController 仍然有重要职责。它决定何时进入 AsyncLoading,把 Repository 的成功或异常结果转换成 AsyncValue,并为 Widget 提供稳定的交互入口。这属于状态协调,而不是底层数据访问。

Repository 则不应该依赖 Widget 或页面状态。这样同一个 AuthRepository 可以被多个 Provider、后台任务或测试复用。AuthApi 只关心如何与外部系统通信,也不需要知道页面当前是否显示加载动画。

这种依赖方向还能直接改善测试:测试 Provider 时可以覆盖 authRepositoryProvider;测试 Repository 时可以替换 AuthApi。每一层只需要验证自己的决策,不必一次启动整个应用链路。

不要为了拆分而制造空壳

职责分离不等于机械地给每个方法增加一层。如果应用只有一个纯内存计数器,让 Notifier 直接修改状态就足够,没有必要创建 Repository 和 Service。

真正值得拆分的信号,是 Provider 开始处理多个独立变化来源,例如网络协议、本地存储、数据转换与页面状态同时出现。此时把 I/O 和数据访问策略下沉,Provider 只保留状态协调,可以让依赖更容易替换,也让每次修改的影响范围更可预测。

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

目录与阅读设置

阅读设置

17

记录一个想法

避免 Provider 承担过多职责

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

登录哪都通