Flutter中FutureBuilder未返回预期页面（Firebase相关问题）

核心问题 #

你的代码存在三个关键问题，导致页面无法按预期返回：

1. Future重复执行：每次build触发时都会重新调用_getCurrentUserData()，Firestore请求重复发起，引发状态混乱。
2. 未处理加载状态：Future还在请求数据时，hasAccountSetup.data为null，此时会直接进入else分支返回AccountSetup，并非真正的false值。
3. 未处理错误与空值场景：Firestore请求失败、字段不存在时会触发异常或返回null，代码未做处理，导致错误分支误触发。

修复后的完整代码 #

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

  @override
  State<YourPage> createState() => _YourPageState();
}

class _YourPageState extends State<YourPage> {
  late Future<bool> _accountSetupFuture;

  @override
  void initState() {
    super.initState();
    // 仅在初始化时执行一次Future，避免重复请求
    _accountSetupFuture = _getCurrentUserData();
  }

  Future<bool> _getCurrentUserData() async {
    // 先检查用户是否仍处于登录状态
    final currentUser = Auth().currentUser;
    if (currentUser == null) return false;

    try {
      final DocumentSnapshot userDoc = await FirebaseFirestore.instance
          .collection('Users')
          .doc(currentUser.uid)
          .get();

      // 处理字段不存在的情况，默认返回false
      return userDoc.get('HasSetupAccount') ?? false;
    } catch (e) {
      // 捕获请求异常，打印错误并返回false
      print('获取用户数据失败: $e');
      return false;
    }
  }

  @override
  Widget build(BuildContext context) {
    return StreamBuilder(
      stream: Auth().authStateChanges,
      builder: (context, snapshot) {
        if (snapshot.hasData) {
          return FutureBuilder<bool>(
              future: _accountSetupFuture,
              builder: (context, hasAccountSetup) {
                // 处理加载状态
                if (hasAccountSetup.connectionState == ConnectionState.waiting) {
                  return const Center(child: CircularProgressIndicator());
                }
                // 处理错误状态
                if (hasAccountSetup.hasError) {
                  return const Center(child: Text('加载失败，请重试'));
                }
                // 处理正常数据
                final hasSetup = hasAccountSetup.data ?? false;
                if (hasSetup) {
                  print("print1");
                  return const MyHomePage();
                } else {
                  print("print2");
                  return const AccountSetup();
                }
              });
        } else {
          return const LoginPage();
        }
      },
    );
  }
}

关键修复点说明 #

• Future初始化优化：将_accountSetupFuture在initState中初始化，确保Firestore请求仅执行一次，避免重复触发。
• 加载状态处理：通过connectionState == ConnectionState.waiting返回加载组件（如圆形进度指示器），避免提前进入错误分支。
• 错误与空值处理：
  • 增加用户登录状态二次检查，避免异步过程中用户登出导致的空指针。
  • 用try-catch捕获Firestore请求异常，避免程序崩溃。
  • 用?? false处理字段不存在的情况，确保返回值始终为布尔类型。
• 明确数据判空：用hasAccountSetup.data ?? false确保即使数据为null也能得到合法的布尔值。

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