Flutter全局变量初始化问题：initState异步操作导致build时变量为空

你遇到的核心问题是：initState是同步执行的方法，它不会等待内部调用的异步函数setAtlasUser执行完成就会结束，随后build方法会立刻触发。这时候current_atlas_user还没完成赋值，自然是null，导致依赖它的NotDoneScreen报错。

下面提供两种简单可行的修复方式：

方式一：用setState触发异步完成后的重渲染 #

修改你的异步初始化函数，在赋值完成后调用setState通知Flutter重新构建页面：

Future<void> setAtlasUser(String email) async {
  try {
    final app = App(AppConfiguration(APP_ID));
    current_atlas_user = await app.logIn(Credentials.emailPassword(email, ATLAS_PASSWD));
    // 确保Widget未被销毁时再调用setState
    if (mounted) {
      setState(() {});
    }
  } catch (e) {
    // 处理登录失败的情况，比如弹窗提示
    print('登录失败: $e');
  }
}

然后在build方法中先判断current_atlas_user是否初始化完成：

@override
Widget build(BuildContext context) {
  // 未初始化完成时显示加载状态
  if (current_atlas_user == null) {
    return const Center(child: CircularProgressIndicator());
  }
  
  List<Widget> _screens = [NotDoneScreen(), const DoneScreen()];
  // 后续你的页面结构代码...
  return Scaffold(
    body: TabBarView(children: _screens),
    // ...其他组件
  );
}

方式二：用FutureBuilder等待异步操作完成 #

将依赖current_atlas_user的页面逻辑包裹在FutureBuilder中，让页面等待初始化完成后再渲染：

// 先在类中定义一个成员变量存储初始化Future
late Future<void> _initUserFuture;

@override
void initState() {
  super.initState();
  // 这里替换成你的实际email值
  _initUserFuture = setAtlasUser('your_user_email');
}

Future<void> setAtlasUser(String email) async {
  final app = App(AppConfiguration(APP_ID));
  current_atlas_user = await app.logIn(Credentials.emailPassword(email, ATLAS_PASSWD));
}

@override
Widget build(BuildContext context) {
  return FutureBuilder(
    future: _initUserFuture,
    builder: (context, snapshot) {
      if (snapshot.connectionState == ConnectionState.done) {
        if (snapshot.hasError) {
          // 处理登录失败
          return Text('登录失败: ${snapshot.error}');
        }
        // 初始化完成后渲染正常页面
        List<Widget> _screens = [NotDoneScreen(), const DoneScreen()];
        return Scaffold(
          body: TabBarView(children: _screens),
          // ...其他组件
        );
      } else {
        // 显示加载状态
        return const Center(child: CircularProgressIndicator());
      }
    },
  );
}

尽量避免使用全局变量管理用户状态，推荐使用Flutter的状态管理方案（比如Provider、Riverpod），这样状态的传递和维护会更规范，也能减少类似的生命周期问题。

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