跨平台开发 / 系统课时
避免循环依赖和职责混乱
避免循环依赖和职责混乱
当 Provider 越来越多,真正危险的往往不是数量,而是依赖关系失控:A 依赖 B,B 又反过来依赖 A,或一个 Provider 同时承担读取、计算和业务动作。本节用依赖图和一个可运行示例,建立可维护的拆分方式。
学习目标
- 能从
ref.watch关系中识别循环依赖和过度耦合。 - 能把源状态、派生计算和业务动作拆成单一职责。
- 能用单向依赖图组织 Provider,降低修改时的连锁影响。
先把 Provider 看成依赖图
当一个 Provider 在创建或计算时调用 ref.watch(otherProvider),它就在读取一个上游依赖。画图时可以按数据变化的传播方向,从上游 Provider 指向派生 Provider。可维护的结构应尽量形成单向无环图:底层状态提供事实,上层 Provider 只做派生。

循环依赖的问题不只是“代码不好看”。如果 A 的构建需要 B,而 B 的构建又需要 A,就没有稳定的求值顺序。另一种更隐蔽的问题是职责混乱:一个 Provider 既读取远端数据、又保存可变状态、又拼装展示文本,任何变化都可能让无关逻辑一起重算。
用单向派生关系拆职责
下面示例把“原始金额”“折扣率”“应付金额”拆开。前两个 Provider 只提供事实,totalProvider 只负责计算,页面只消费最终结果。示例假设 Flutter 项目已经添加 flutter_riverpod 依赖。
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
final subtotalProvider = Provider<double>((ref) => 120.0);
final discountRateProvider = Provider<double>((ref) => 0.25);
final totalProvider = Provider<double>((ref) {
// 派生 Provider 只读取上游事实并完成计算。
final subtotal = ref.watch(subtotalProvider);
final discountRate = ref.watch(discountRateProvider);
return subtotal * (1 - discountRate);
});
void main() {
runApp(const ProviderScope(child: MyApp()));
}
class MyApp extends ConsumerWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context, WidgetRef ref) {
final total = ref.watch(totalProvider);
return MaterialApp(
home: Scaffold(
body: Center(
child: Text('应付:¥${total.toStringAsFixed(2)}'),
),
),
);
}
}预期结果
页面显示:应付:¥90.00这个结构里,读取关系始终是派生结果读取上游事实,状态变化则沿图中的箭头向下游传播。将来折扣来源改成用户等级或远端配置时,只需要替换折扣率的提供方式,不必把金额计算塞进页面,也不需要让源 Provider 反向读取 totalProvider。
发现环时先改数据流方向
看到两个 Provider 互相 watch 时,不要通过改成 read 来“绕过”依赖图。read 只是改变订阅行为,并不会自动修正职责问题。更有效的做法是找出双方共同需要的事实,把它下沉为第三个 Provider,再让原来的两个 Provider 单向依赖这个事实。
如果两个模块必须互相触发动作,通常应把“状态读取”和“动作协调”分开:状态由 Notifier 或其他状态持有者管理,派生 Provider 只读状态;跨模块动作放到更明确的业务协调层,而不是让两个派生 Provider 互相调用。
判断是否已经拆得足够清楚
一个 Provider 最好能用一句话描述职责,例如“提供当前折扣率”或“根据金额和折扣计算应付金额”。如果描述里频繁出现“并且”“同时还负责”,通常已经承担了过多职责。
检查依赖时,重点看三件事:是否存在回到起点的路径;上游 Provider 是否反向依赖展示层结果;修改某个规则时是否会迫使无关 Provider 一起改。依赖保持单向、职责能够独立命名时,Provider 组合通常就足够稳定。