Flutter已登录用户跳转首页报错：userInfo未初始化问题求助

错误原因 #

你遇到的LateInitializationError是因为用late修饰的userInfo变量在被访问时还未完成初始化。核心问题是从SharedPreferences读取用户信息是异步操作，但页面的build方法是同步执行的，导致异步操作还没完成就尝试访问userInfo。

具体解决方案 #

结合你的登录跳转场景，推荐两种直接可行的修复方式：

方案1：闪屏页预加载用户信息，跳转时传递给HomePage #

既然闪屏页已经在判断登录状态，直接在这里完成用户信息的读取，再把数据传递给HomePage，避免HomePage处理异步逻辑：

// 闪屏页的登录状态检查逻辑
void _checkAuthStatus() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  bool isLoggedIn = prefs.getBool('isLoggedIn') ?? false;
  
  if (isLoggedIn) {
    // 读取并解析用户信息
    String? userInfoJson = prefs.getString('userInfo');
    if (userInfoJson != null) {
      UserInfo userInfo = UserInfo.fromJson(jsonDecode(userInfoJson));
      // 直接传递userInfo到HomePage
      Navigator.pushReplacement(
        context,
        MaterialPageRoute(builder: (_) => HomePage(userInfo: userInfo))
      );
      return;
    }
  }
  
  // 未登录或读取失败，跳转协议页
  Navigator.pushReplacement(
    context,
    MaterialPageRoute(builder: (_) => AgreementPage())
  );
}

修改HomePage通过构造函数接收参数：

class HomePage extends StatelessWidget {
  final UserInfo userInfo;

  const HomePage({super.key, required this.userInfo});

  @override
  Widget build(BuildContext context) {
    // 直接使用userInfo，无需担心未初始化
    return Scaffold(
      appBar: AppBar(title: Text(userInfo.nickname)),
      // ...其他页面内容
    );
  }
}

方案2：HomePage内用FutureBuilder处理异步加载 #

如果必须在HomePage内部读取用户信息，用FutureBuilder等待异步操作完成后再构建页面：

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

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  late Future<UserInfo> _userInfoFuture;

  @override
  void initState() {
    super.initState();
    // 初始化Future，避免每次build都重复执行异步操作
    _userInfoFuture = _loadUserInfo();
  }

  Future<UserInfo> _loadUserInfo() async {
    SharedPreferences prefs = await SharedPreferences.getInstance();
    String? userInfoJson = prefs.getString('userInfo');
    if (userInfoJson == null) {
      // 读取失败可抛出错误或返回默认值
      throw Exception('用户信息不存在');
    }
    return UserInfo.fromJson(jsonDecode(userInfoJson));
  }

  @override
  Widget build(BuildContext context) {
    return FutureBuilder<UserInfo>(
      future: _userInfoFuture,
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
          // 加载中显示进度条
          return const Center(child: CircularProgressIndicator());
        } else if (snapshot.hasError) {
          // 加载失败显示提示
          return const Center(child: Text('加载用户信息失败'));
        } else {
          // 数据加载完成，构建页面
          UserInfo userInfo = snapshot.data!;
          return Scaffold(
            appBar: AppBar(title: Text(userInfo.nickname)),
            // ...其他页面内容
          );
        }
      },
    );
  }
}

注意事项 #

• 不要在build方法中直接执行异步操作，否则页面每次刷新都会重复执行，影响性能。
• 异步场景下尽量避免用late修饰变量，改用Future或可空类型（UserInfo?）配合空安全处理，能从根源避免初始化错误。

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