You need to enable JavaScript to run this app. Flutter使用类级全局变量存储缓存,为何热重载/UI重建时缓存失效重复发请求
优惠活动
大模型
产品
解决方案
定价
更多

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类上,要放到两个位置之一:

  1. 对应组件的State类实例里(适合只在当前页面存活周期内有效的缓存)
  2. 全局单例/静态变量(适合跨页面、跨组件重建需要保留的全局缓存)

参考实现代码

错误写法:把缓存写在临时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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.22 12:15:07