Flutter中Riverpod生成的Provider资源释放位置咨询

数据老陈

2026-7-23

Riverpod Notifier中释放BehaviorSubject及流订阅的正确姿势

首先明确：绝对不能在build()方法里处理资源释放，这是错误的做法。

为什么build()不行？

build()方法的作用是初始化Notifier的状态或执行状态计算，它会在Provider首次创建时执行一次，但如果后续通过ref.invalidate()强制刷新Provider，build()会再次执行。如果在build()里关闭BehaviorSubject或取消订阅，会导致：

首次build后资源被释放，后续操作流时触发"已关闭的流"错误
多次build重复执行释放逻辑，引发不必要的异常

正确的位置：Notifier的dispose()方法

Riverpod的Notifier类提供了dispose()回调，这个方法会在Provider被销毁（比如页面销毁、Provider不再被监听）时仅执行一次，是专门用来清理资源的地方。

示例代码

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

@riverpod
class CounterController extends _$CounterController {
  late final BehaviorSubject<int> _counterSubject;
  late final StreamSubscription<int> _streamSubscription;

  @override
  int build() {
    // 初始化流资源，build仅执行一次（除非手动刷新Provider）
    _counterSubject = BehaviorSubject.seeded(0);
    _streamSubscription = _counterSubject.listen((newCount) {
      state = newCount;
    });
    return _counterSubject.value;
  }

  // 业务方法：更新计数
  void increment() {
    _counterSubject.add(state + 1);
  }

  @override
  void dispose() {
    // 在这里统一释放资源，仅执行一次
    _streamSubscription.cancel();
    _counterSubject.close();
    super.dispose();
  }
}