Flutter+Cloud Firestore：如何检测集合不存在并跳转新用户页面？

你的核心问题是：Cloud Firestore中不存在的集合/空集合会返回一个空的快照对象，而非snapshot.hasData为false，导致原代码的判断逻辑失效。因为即使集合不存在，snapshot.hasData依然为true（快照对象本身存在，只是没有数据），所以无法触发跳转到PageForNewUser的逻辑。

以下是两种可靠的实现方式，可根据你的需求选择：

方式一：监听集合并检查文档数量（支持实时更新） #

修改StreamBuilder的判断逻辑，通过快照内的文档数量来判断用户是否已完成初始化：

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

  @override
  State<CheckingUserStatus> createState() => _CheckingUserStatusState();
}

class _CheckingUserStatusState extends State<CheckingUserStatus> {
  final String? _email = FirebaseAuth.instance.currentUser?.email;

  @override
  Widget build(BuildContext context) {
    // 先判断用户是否已登录
    if (_email == null) {
      return const Scaffold(body: Center(child: Text('请先登录')));
    }

    return Scaffold(
      body: StreamBuilder<QuerySnapshot>(
        stream: FirebaseFirestore.instance
            .collection('$_email data')
            .doc('data')
            .collection('currentTemplate')
            .snapshots(),
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }

          // 快照存在时，检查是否有有效文档
          if (snapshot.hasData && snapshot.data!.docs.isNotEmpty) {
            return const UserPreferencesManager();
          } else {
            // 集合不存在或无文档，视为新用户
            return const PageForNewUser();
          }
        },
      ),
    );
  }
}

方式二：查询用户主文档（仅初始化检查，性能更优） #

如果不需要实时监听数据变化，建议用FutureBuilder直接查询用户的主文档（如data文档），逻辑更清晰且性能更好：

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

  @override
  State<CheckingUserStatus> createState() => _CheckingUserStatusState();
}

class _CheckingUserStatusState extends State<CheckingUserStatus> {
  final String? _email = FirebaseAuth.instance.currentUser?.email;

  // 定义检查用户是否已初始化的异步方法
  Future<bool> isUserInitialized() async {
    if (_email == null) return false;
    DocumentSnapshot mainDoc = await FirebaseFirestore.instance
        .collection('$_email data')
        .doc('data')
        .get();
    
    // 先检查主文档是否存在，再验证子集合是否有数据
    if (mainDoc.exists) {
      QuerySnapshot templateSnapshot = await mainDoc.reference.collection('currentTemplate').get();
      return templateSnapshot.docs.isNotEmpty;
    }
    return false;
  }

  @override
  Widget build(BuildContext context) {
    if (_email == null) {
      return const Scaffold(body: Center(child: Text('请先登录')));
    }

    return Scaffold(
      body: FutureBuilder<bool>(
        future: isUserInitialized(),
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }

          // 根据检查结果跳转对应页面
          return snapshot.data == true 
              ? const UserPreferencesManager() 
              : const PageForNewUser();
        },
      ),
    );
  }
}

• Firestore特性：查询不存在的集合时，不会返回错误，而是返回空的QuerySnapshot，因此必须通过docs.isEmpty判断是否有有效数据，而非仅依赖snapshot.hasData。
• 登录状态校验：必须先判断FirebaseAuth.instance.currentUser是否为null，避免未登录场景下的空指针异常。
• 性能选择：仅启动时检查用FutureBuilder，需要实时同步数据变化用StreamBuilder。

内容的提问来源于stack exchange，提问作者Сергей Виршке