Flutter用FutureBuilder配置MaterialApp home时Firebase角色校验卡加载问题

问题根源 #

你的代码始终卡在加载状态，核心是异步逻辑的返回和初始化存在3个明显错误：

• userInfo只做了类型声明，没有赋值为你定义的fetchInfoUtente()异步方法，调用userInfo.then相当于对未初始化的空Future操作，永远不会返回结果
• widgetChoice方法的else分支没有返回值：你调用了userInfo.then但没有把这个then返回的Future作为方法返回值，async方法无返回时默认返回Future<void>，导致FutureBuilder永远拿不到Widget类型的返回数据
• 额外风险：你用了未定义来源的isLogged变量判断登录状态，不如直接判断FirebaseAuth.instance.currentUser是否为空更准确

修复方案 #

你的整体实现思路是合理的，启动阶段用FutureBuilder等待异步校验结果、根据返回值跳转对应页面，适合简单的启动校验场景。下面是修复后的可运行代码：

final usersCollection = FirebaseFirestore.instance.collection('users');

// 查询用户信息方法调整为接收uid参数，避免依赖全局变量
Future<InfoUtente> fetchInfoUtente(String uid) async {
  final response = await usersCollection
      .where('uid', isEqualTo: uid)
      .get();
  return InfoUtente.fromFireStore(response.docs.first);
}

// 重写页面判断逻辑，用async/await替代.then写法，保证所有分支都有返回值
Future<Widget> widgetChoice() async {
  User? loggedUser = FirebaseAuth.instance.currentUser;
  // 未登录直接返回登录页
  if (loggedUser == null) {
    return const LoginNewPage();
  }
  // 已登录则查询用户等级判断跳转目标
  InfoUtente userInfo = await fetchInfoUtente(loggedUser.uid);
  if (userInfo.loginLevel == 'struttura') {
    return const StrutturaPage();
  } else {
    return const MainPage();
  }
}

@override
Widget build(BuildContext context) {
  return MaterialApp(
    debugShowCheckedModeBanner: false,
    title: 'Flutter Demo',
    theme: ThemeData(
      primarySwatch: Colors.blue,
    ),
    home: FutureBuilder(
      future: widgetChoice(),
      builder: (BuildContext context, AsyncSnapshot<Widget> snapshot) {
        // 新增错误处理，避免网络/数据库查询失败导致崩溃
        if (snapshot.hasError) {
          return const Center(child: Text('加载失败，请重启应用'));
        }
        if (snapshot.hasData) {
          return snapshot.data!;
        }
        return const Center(child: CircularProgressIndicator());
      },
    ),
  );
}

扩展优化建议 #

如果后续需要支持登录状态动态变化（比如用户在应用内登出、token过期自动下线），可以替换为监听FirebaseAuth的authStateChanges()流，配合StreamBuilder实现状态自动更新，无需用户手动重启应用即可跳转页面。

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