Flutter使用类级全局变量存储缓存,为何热重载/UI重建时缓存失效重复发请求
缓存异常失效的核心根因
从C#转Flutter最容易踩的认知差,就是没搞懂两类类的生命周期差异:
- Flutter里
StatefulWidget本身是不可变的临时配置对象,框架每次触发UI重建(不管是父组件重绘、setState、还是热重载)都会生成一个全新的Widget实例。你写在Widget类上的所有动态成员变量,都会跟着新实例被重置成初始值,和C#里长期存活的窗体类完全不是一个逻辑。 - 你之前的代码把
_lastUpdatedTime、previousFetchedUsage都定义在HomeView(也就是StatefulWidget本身)的类上,哪怕在State里通过widget.xxx访问,拿到的也是每次新建Widget带来的空值,自然永远判定缓存无效,每次都发新请求。 - 把
previousFetchedUsage改成静态变量之后还是出问题,是因为_lastUpdatedTime你没移到持久存储的位置,每次访问的时候都是新Widget带来的初始null值,判断逻辑直接返回缓存失效,哪怕数据存在静态变量里,照样会触发接口请求。
正确实现方案
存储位置调整
所有需要跨UI重建保留的动态缓存值,绝对不能存在临时的Widget类上,要放到两个位置之一:
- 对应组件的State类实例里(适合只在当前页面存活周期内有效的缓存)
- 全局单例/静态变量(适合跨页面、跨组件重建需要保留的全局缓存)
参考实现代码
错误写法:把缓存写在临时Widget类上
class HomeView extends StatefulWidget { // 配置类常量放这里没问题 final int maxCacheDurationInMinutes = 2; // 动态缓存放这里是完全错误的,每次重建都会被清空 DateTime? _lastUpdatedTime; UsageModel? previousFetchedUsage; @override State<HomeView> createState() => _HomeViewState(); }
正确写法:把动态缓存移到State类中
class HomeView extends StatefulWidget { // 固定配置项放在Widget类上即可,每次重建值都不变 final int maxCacheDurationInMinutes = 2; const HomeView({super.key}); @override State<HomeView> createState() => _HomeViewState(); } class _HomeViewState extends State<HomeView> { // 动态缓存全部放在State实例上,只要组件不被销毁,值就会一直保留 DateTime? _lastUpdatedTime; UsageModel? _previousFetchedUsage; // 缓存有效性判断 bool get _isValidCache { // 缓存非空 + 未超过有效期才算有效 if (_previousFetchedUsage == null || _lastUpdatedTime == null) { return false; } final cacheAge = DateTime.now().difference(_lastUpdatedTime!); return cacheAge.inMinutes < widget.maxCacheDurationInMinutes; } Future<void> fetchUsageData() async { // 命中有效缓存直接返回,不发请求 if (_isValidCache) return; // 缓存失效才发起接口请求 final res = await apiClient.fetchUsageData(); // 更新本地缓存 setState(() { _previousFetchedUsage = res; _lastUpdatedTime = DateTime.now(); }); } @override void initState() { super.initState(); // 页面首次挂载时触发数据拉取 fetchUsageData(); } @override Widget build(BuildContext context) { return Scaffold( body: Center( child: Text( _previousFetchedUsage?.displayText ?? "数据加载中...", ), ), ); } }
场景验证
- 常规UI重建:比如父组件重绘、页面内部setState触发build重新执行,State实例不会被销毁,里面的缓存值会完整保留,只要没到2分钟有效期,就不会重复发请求。
- 热重载场景:默认热重载(按r键)会保留现有State实例,仅重新注入新的Widget配置,缓存值完全保留,不会触发重复请求;只有热重启(按R键)才会清空所有内存状态,重新走初始化拉取流程。
- 要是需要缓存的存活周期超过当前页面的销毁周期,直接把
_lastUpdatedTime、_previousFetchedUsage抽到独立的全局缓存服务里,做成单例存储即可。
内容的提问来源于stack exchange,提问作者Arun Prakash
相关产品推荐
相关产品推荐

