跨平台开发 / 系统课时

用 autoDispose 释放闲置状态

用 autoDispose 释放闲置状态

页面离开后,如果请求结果、搜索条件或临时对象仍被 Provider 缓存,就会继续占用内存甚至持有资源。本节用 autoDispose 让无人监听的状态自动销毁,并说明重新进入页面、主动保留缓存和资源清理时分别会发生什么。

学习目标

  • 理解 autoDispose 根据监听关系释放 Provider 状态的机制
  • 为页面级异步数据正确使用自动销毁,并验证销毁行为
  • 判断什么时候应该配合 ref.keepAlive() 或 ref.onDispose()

autoDispose 解决什么问题

普通 Provider 在容器存活期间可以继续保留已经创建的状态。对于应用配置、登录会话等全局状态,这通常正是需要的;但搜索页结果、详情页请求、临时筛选条件等状态离开页面后往往已经没有价值。

autoDispose 把状态生命周期与监听关系绑定起来。当 Provider 不再被监听,并且框架确认没有新的监听者继续使用它时,其状态可以被销毁。以后再次监听同一个 Provider,会重新创建状态,而不是直接沿用已经销毁的实例。

autoDispose 从监听到销毁再重建的生命周期

这意味着 autoDispose 很适合生命周期明显短于整个应用的状态,例如页面详情、一次搜索、临时表单辅助数据以及仅在某个路由内使用的异步结果。

在页面离开后自动释放状态

下面的完整示例声明一个 FutureProvider.autoDispose。详情区域显示时,Widget 会监听 Provider;隐藏详情区域后没有任何监听者,Provider 随后被释放,并通过 ref.onDispose() 打印清理日志。

dart
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。点击“隐藏详情”使最后一个监听者消失后,调试控制台会出现类似以下日志:

text
profileProvider disposed

再次点击“显示详情”时会重新进入加载状态,约 1 秒后再次显示 用户:Alice,说明此前的 Provider 状态已经被销毁并重新创建。

销毁状态不等于自动取消所有工作

autoDispose 会销毁 Provider 状态,但不能假定所有外部异步操作都会因此自动停止。例如自行创建的网络请求、流订阅、定时器或控制器是否需要额外取消,取决于对应 API。

这类资源应把清理动作注册到 ref.onDispose()。这样 Provider 生命周期结束时,资源释放逻辑与状态销毁发生在同一处,不需要依赖某个 Widget 恰好执行清理。

只在有价值时保留缓存

有些数据虽然属于页面状态,但首次加载成本较高,希望成功获取后暂时避免立即重建。自动销毁 Provider 可以根据业务条件调用 ref.keepAlive(),让当前状态在失去监听后继续保留。

下面是片段示例,需放在 FutureProvider.autoDispose 的回调中使用:

dart
final articleProvider = FutureProvider.autoDispose<String>((ref) async {
  final article = await loadArticle();

  // 只有成功结果值得继续缓存,失败或未完成状态仍可自动释放。
  ref.keepAlive();
  return article;
});

这里的关键不是“所有请求完成后都 keepAlive”,而是先决定状态是否值得跨页面继续存在。若数据必须始终常驻,就应重新评估它是否应该使用 autoDispose;若只是希望在特定条件下延长缓存,autoDispose 配合 ref.keepAlive() 才能保持生命周期策略清晰。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 autoDispose 释放闲置状态

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

登录哪都通