Flutter存Firebase数据到Shared Preferences报LateInitializationError如何解决

你遇到的报错本质是触发了两个Flutter异步操作常见的时序和空安全问题：

• initState本身是同步生命周期方法，你放在其中的异步操作（Firebase拉取数据、存SP、读SP）不会阻塞页面渲染，而且存SP的操作依赖异步返回的Firebase数据，你读SP时大概率存操作还没执行完成，自然读不到值返回null
• 你使用!强制解包getString的返回值，而SharedPreferences的getString方法本身就允许返回null，强制解包null就会直接抛出LateInitializationError

• 第一步：调整存储逻辑的执行时机，把存SP的逻辑从个人资料页挪到登录页Firebase请求成功的回调中，存完数据再跳转个人资料页，保证跳转前SP已经写入完成
  参考代码：

  //Login Button onPressed
  getUserContent() async {
    try {
      await fireStore.collection("SomeCollection").doc(uid)
        .get()
        .then((value) async {
          userData = (value.data()!);
          // 登录页拉到数据后直接存SP
          String someString = userData!['Name'].toString();
          SharedPreferences prefs = await SharedPreferences.getInstance();
          await prefs.setString('someStringKey', someString);
          // 存储完成再跳转个人资料页
          if(mounted) Navigator.push(context, MaterialPageRoute(builder: (context)=> const ProfilePage()));
      });
    } catch(e) {
      // 新增异常捕获，处理网络请求、存储失败的场景
    }
  }
  

• 第二步：个人资料页使用FutureBuilder处理SP异步读取逻辑，同时做null判断兜底，不要强制解包可能为null的返回值
  参考代码：

  late Future<String?> spStringFuture;
  
  @override
  void initState() {
    super.initState();
    // 初始化时只触发读SP的异步任务
    spStringFuture = SharedPreferences.getInstance().then((prefs) => prefs.getString('someStringKey'));
  }
  
  @override
  Widget build(BuildContext context) {
    return FutureBuilder<String?>(
      future: spStringFuture,
      builder: (context, snapshot) {
        // 加载中展示占位图
        if(snapshot.connectionState == ConnectionState.waiting) {
          return const Center(child: CircularProgressIndicator());
        }
        // 读不到数据的兜底逻辑，可跳转回登录页
        if(snapshot.hasError || !snapshot.hasData || snapshot.data == null) {
          return const Center(child: Text('未检测到登录信息'));
        }
        // 确认有值后再正常渲染页面
        final spString = snapshot.data!;
        return Scaffold(body: Center(child: Text('用户名：$spString')));
      },
    );
  }
  

• 第三步：后续可以新增启动页逻辑，应用打开时先读SP判断是否有登录凭证，有就直接进入个人资料页，没有就进入登录页，实现免重复登录的需求

• 静态变量userData在应用重启后会被重置，不要依赖它做持久化判断，所有登录态校验逻辑都要以SharedPreferences存储的内容为准
• 所有异步操作都建议加异常捕获，避免网络请求失败、SP读写失败导致应用直接崩溃

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