Flutter Restoration无法保存或恢复状态？已尝试官方示例及社区方案

必查基础配置 #

• 确保根组件（MaterialApp/CupertinoApp）已设置全局恢复ID：

  MaterialApp(
    restorationScopeId: 'my_app', // 必须设置，全局恢复的入口
    // ...其他配置
  )
  

• 检查页面状态类的RestorationMixin实现是否完整：
  • 必须混入RestorationMixin，并重写restorationId
  • 使用RestorableXXX类型（如RestorableInt、RestorableString）存储需要恢复的值，禁止用普通变量
  • 在restoreState中调用registerForRestoration绑定属性与恢复键
  • 记得在dispose中销毁RestorableProperty

正确实现示例片段 #

class _CounterPageState extends State<CounterPage> with RestorationMixin {
  // 用RestorableInt替代普通int
  final RestorableInt _count = RestorableInt(0);

  @override
  String? get restorationId => 'counter_page'; // 页面级恢复ID

  @override
  void restoreState(RestorationBucket? oldBucket, bool initialRestore) {
    // 绑定属性与恢复键，键名要唯一
    registerForRestoration(_count, 'page_counter');
  }

  @override
  void dispose() {
    _count.dispose(); // 必须销毁，避免内存泄漏
    super.dispose();
  }

  void _addCount() {
    setState(() {
      _count.value++; // 操作RestorableProperty的value属性
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(child: Text('当前计数：${_count.value}')),
      floatingActionButton: FloatingActionButton(onPressed: _addCount),
    );
  }
}

测试方式误区修正 #

• 不要用热重启/杀进程的方式测试，必须通过系统正常退出应用（Android按返回键退出、iOS上滑关闭应用），再重新打开
• 部分模拟器/真机存在缓存，测试前可清理应用缓存后重试
• 崩溃退出的应用不会保存状态，确保测试时是正常退出

额外排查点 #

• 如果使用第三方状态管理（Provider/Riverpod等），需确保状态类也适配恢复逻辑，或与RestorationMixin配合使用
• 不要在initState中硬初始化值，应依赖RestorableProperty的初始值或恢复后的值

内容的提问来源于stack exchange，提问作者Kenny Tran