Flutter主路由使用FutureBuilder始终返回无数据问题求助

你遇到的FutureBuilder始终返回“No Data exists”，核心原因是AsyncSnapshot.hasData为false，大概率是landingPage()这个Future抛出了异常，或是异步流程中出现了空安全问题，以下是具体排查点和修复方案：

1. 修正Firestore字段拼写错误 #

checkAge函数里的查询字段birtDate是拼写错误，正确应为birthDate，这个错误会导致查询无结果，甚至可能引发后续逻辑异常：

Future<bool> checkAge(String uid) async {
  QuerySnapshot snapshot = await FirebaseFirestore.instance.collection("users")
    .where("uid", isEqualTo: uid) // 改用传入的uid，避免依赖currentUser的动态变化
    .where("birthDate", isNull: false) // 修正字段拼写
    .get();

  return snapshot.size > 0;
}

2. 处理异步流程中的用户状态变化 #

在landingPage的异步执行过程中，FirebaseAuth.instance.currentUser可能变为null（比如用户中途登出），直接用!强制解包会抛出异常，导致Future进入错误状态，此时hasData会变为false：

Future<Widget> landingPage() async {
  final user = FirebaseAuth.instance.currentUser;
  if(user == null){
    return const LoginPage();
  }
  if(!user.emailVerified){
    return const EmailVerificationPage();
  }
  // 使用提前获取的user.uid，避免后续currentUser状态变化引发问题
  if(! await checkAge(user.uid)){
    return const AgePage();
  }
  return const HomePage();
}

3. 新增FutureBuilder的错误处理分支 #

当前代码只判断了hasData，但未处理Future抛出异常的情况，导致错误时也会显示“No Data exists”，需要补充错误处理：

FutureBuilder(
  future: landingPage(),
  builder: (BuildContext context, AsyncSnapshot<Widget> snapshot) {
    if(snapshot.connectionState == ConnectionState.done){
      if(snapshot.hasError) { // 新增错误展示逻辑
        return Center(
          child: Text("加载出错: ${snapshot.error}"),
        );
      }
      if(!snapshot.hasData) {
        return const Center(
          child: Text("No Data exists"),
        );
      }
      return snapshot.data!;
    }
    return const Center(
      child: CircularProgressIndicator(
        color: Colors.white,
      ),
    );
  },
)

4. 避免Future在build中重复执行 #

直接在build方法里调用landingPage()会导致每次Widget重建时都重新发起异步请求，引发不必要的资源消耗和状态混乱。可以将Future移到State的初始化阶段（改为StatefulWidget）：

class App extends StatefulWidget {
  const App({Key? key}) : super(key: key);

  @override
  State<App> createState() => _AppState();
}

class _AppState extends State<App> {
  late final Future<Widget> _landingFuture;

  @override
  void initState() {
    super.initState();
    _landingFuture = landingPage(); // 仅在初始化时执行一次
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      initialRoute: "/",
      routes: {
        "/": (context) => FutureBuilder(
          future: _landingFuture,
          builder: (BuildContext context, AsyncSnapshot<Widget> snapshot) {
            // 上述的builder逻辑
          },
        ),
        "/email-verification":(context) => const EmailVerificationPage(),
        "/login":(context) => const LoginPage(),
        "/name-age":(context) => const AgePage(),
        "/signup":(context) => const SignupPage(),
      },
    );
  }
}

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