Flutter应用LateInitializationError问题及状态恢复需求求助

问题根源 #

你遇到的LateInitializationError: Field 'prefs' has not been initialized错误，本质是标记为late的SharedPreferences变量在异步初始化完成前就被访问。SharedPreferences.getInstance()是异步方法，无法同步获取实例，直接用late修饰后未等待初始化完成就调用，必然触发未初始化错误。

修复方案与示例代码 #

以下是一个完整的示例，实现"重启应用恢复操作状态"的功能（以计数器为例，重启后恢复上次的计数值）：

import 'package:flutter/material.dart';
import 'package:shared_preferences/shared_preferences.dart';

class RestoreStatePage extends StatefulWidget {
  const RestoreStatePage({super.key});

  @override
  State<RestoreStatePage> createState() => _RestoreStatePageState();
}

class _RestoreStatePageState extends State<RestoreStatePage> {
  // 用可空类型替代late，避免未初始化错误
  SharedPreferences? _prefs;
  int _counter = 0;

  @override
  void initState() {
    super.initState();
    // 异步初始化SharedPreferences并加载保存的状态
    _initPrefsAndLoadState();
  }

  // 初始化SharedPreferences并恢复状态
  Future<void> _initPrefsAndLoadState() async {
    _prefs = await SharedPreferences.getInstance();
    // 从SharedPreferences读取保存的计数值，默认0
    setState(() {
      _counter = _prefs?.getInt('counter') ?? 0;
    });
  }

  // 保存当前状态到SharedPreferences
  Future<void> _saveCounterState() async {
    if (_prefs == null) return; // 确保prefs已初始化
    await _prefs?.setInt('counter', _counter);
  }

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
    // 每次计数变化时保存状态
    _saveCounterState();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('状态恢复示例')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text('当前计数：'),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: '增加',
        child: const Icon(Icons.add),
      ),
    );
  }
}

关键要点说明 #

• 避免late强制非空：使用SharedPreferences? _prefs可空类型，防止未初始化时的强制访问错误。
• 异步初始化+状态更新：在initState中调用异步方法初始化_prefs，并通过setState刷新UI，确保状态恢复后界面同步更新。
• 安全保存状态：保存前先判断_prefs是否不为空，避免空指针异常。
• 即时保存：在状态变更时（如点击计数器按钮）立即调用保存方法，确保操作状态被及时持久化。

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