Flutter如何异步设置应用首页？build/initState异步不可用如何解决

核心错误原因 #

• Flutter的生命周期方法initState、build的签名都是同步返回，不支持async修饰，你无法通过直接修改这两个方法为异步来实现需求。
• build方法需要同步返回Widget，await会让返回值变成Future，不符合方法定义要求。

方案1：使用FutureBuilder（官方推荐简洁方案） #

你可以直接在home参数中传入FutureBuilder，自动监听异步方法的执行状态，根据状态返回对应页面：

class _MyAppState extends State<MyApp> {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'WizTkt',
      theme: Theme.of(context).copyWith(
          appBarTheme: Theme.of(context)
              .appBarTheme
              .copyWith(brightness: Brightness.dark),
          primaryColor: Colors.blue),
      home: FutureBuilder(
        future: AuthUser.getCurrentUser(),
        builder: (context, snapshot) {
          // 异步加载中，返回加载页/闪屏页
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Scaffold(body: Center(child: CircularProgressIndicator()));
          }
          // 加载完成，判断用户登录状态
          if (snapshot.hasData && snapshot.data != null) {
            return NavBarPage();
          } else {
            return OnBoardingWidget();
          }
        },
      ),
    );
  }
}

如果需要处理异常场景，可以额外加snapshot.hasError的判断分支。

方案2：initState中执行异步逻辑+setState更新 #

如果你不想用FutureBuilder，也可以在initState内部调用异步方法，执行完成后调用setState更新首页：

class _MyAppState extends State<MyApp> {
  Widget? _homeWidget;

  @override
  void initState() {
    super.initState();
    // 内部调用异步方法，不要给initState加async修饰
    _loadUserState();
  }

  Future<void> _loadUserState() async {
    final user = await AuthUser.getCurrentUser();
    setState(() {
      _homeWidget = user != null ? NavBarPage() : OnBoardingWidget();
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'WizTkt',
      theme: Theme.of(context).copyWith(
          appBarTheme: Theme.of(context)
              .appBarTheme
              .copyWith(brightness: Brightness.dark),
          primaryColor: Colors.blue),
      // 加载完成前显示加载页
      home: _homeWidget ?? const Scaffold(body: Center(child: CircularProgressIndicator())),
    );
  }
}

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