跨平台开发 / 系统课时
用 autoDispose 释放闲置状态
用 autoDispose 释放闲置状态
页面离开后,如果请求结果、搜索条件或临时对象仍被 Provider 缓存,就会继续占用内存甚至持有资源。本节用 autoDispose 让无人监听的状态自动销毁,并说明重新进入页面、主动保留缓存和资源清理时分别会发生什么。
学习目标
- 理解
autoDispose根据监听关系释放 Provider 状态的机制 - 为页面级异步数据正确使用自动销毁,并验证销毁行为
- 判断什么时候应该配合
ref.keepAlive()或ref.onDispose()
autoDispose 解决什么问题
普通 Provider 在容器存活期间可以继续保留已经创建的状态。对于应用配置、登录会话等全局状态,这通常正是需要的;但搜索页结果、详情页请求、临时筛选条件等状态离开页面后往往已经没有价值。
autoDispose 把状态生命周期与监听关系绑定起来。当 Provider 不再被监听,并且框架确认没有新的监听者继续使用它时,其状态可以被销毁。以后再次监听同一个 Provider,会重新创建状态,而不是直接沿用已经销毁的实例。

这意味着 autoDispose 很适合生命周期明显短于整个应用的状态,例如页面详情、一次搜索、临时表单辅助数据以及仅在某个路由内使用的异步结果。
在页面离开后自动释放状态
下面的完整示例声明一个 FutureProvider.autoDispose。详情区域显示时,Widget 会监听 Provider;隐藏详情区域后没有任何监听者,Provider 随后被释放,并通过 ref.onDispose() 打印清理日志。
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
final profileProvider = FutureProvider.autoDispose<String>((ref) async {
ref.onDispose(() {
debugPrint('profileProvider disposed');
});
await Future<void>.delayed(const Duration(seconds: 1));
return 'Alice';
});
void main() {
runApp(const ProviderScope(child: DemoApp()));
}
class DemoApp extends StatefulWidget {
const DemoApp({super.key});
@override
State<DemoApp> createState() => _DemoAppState();
}
class _DemoAppState extends State<DemoApp> {
bool _showProfile = true;
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
appBar: AppBar(title: const Text('autoDispose demo')),
body: Padding(
padding: const EdgeInsets.all(24),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
ElevatedButton(
onPressed: () {
setState(() => _showProfile = !_showProfile);
},
child: Text(_showProfile ? '隐藏详情' : '显示详情'),
),
const SizedBox(height: 16),
if (_showProfile)
Consumer(
builder: (context, ref, child) {
final profile = ref.watch(profileProvider);
return profile.when(
data: (name) => Text('用户:$name'),
loading: () => const CircularProgressIndicator(),
error: (error, stackTrace) => Text('加载失败:$error'),
);
},
),
],
),
),
),
);
}
}预期结果
应用启动约 1 秒后页面显示 用户:Alice。点击“隐藏详情”使最后一个监听者消失后,调试控制台会出现类似以下日志:
profileProvider disposed再次点击“显示详情”时会重新进入加载状态,约 1 秒后再次显示 用户:Alice,说明此前的 Provider 状态已经被销毁并重新创建。
销毁状态不等于自动取消所有工作
autoDispose 会销毁 Provider 状态,但不能假定所有外部异步操作都会因此自动停止。例如自行创建的网络请求、流订阅、定时器或控制器是否需要额外取消,取决于对应 API。
这类资源应把清理动作注册到 ref.onDispose()。这样 Provider 生命周期结束时,资源释放逻辑与状态销毁发生在同一处,不需要依赖某个 Widget 恰好执行清理。
只在有价值时保留缓存
有些数据虽然属于页面状态,但首次加载成本较高,希望成功获取后暂时避免立即重建。自动销毁 Provider 可以根据业务条件调用 ref.keepAlive(),让当前状态在失去监听后继续保留。
下面是片段示例,需放在 FutureProvider.autoDispose 的回调中使用:
final articleProvider = FutureProvider.autoDispose<String>((ref) async {
final article = await loadArticle();
// 只有成功结果值得继续缓存,失败或未完成状态仍可自动释放。
ref.keepAlive();
return article;
});这里的关键不是“所有请求完成后都 keepAlive”,而是先决定状态是否值得跨页面继续存在。若数据必须始终常驻,就应重新评估它是否应该使用 autoDispose;若只是希望在特定条件下延长缓存,autoDispose 配合 ref.keepAlive() 才能保持生命周期策略清晰。