Flutter Firebase双角色登录报错：Bad state字段不存在求助

错误原因 #

你遇到的Bad state: cannot get a field on a DocumentSnapshotPlatform which does not exist错误，本质是代码尝试读取Firestore文档中不存在的role字段，常见触发场景：

• 登录用户对应的users集合文档未创建
• 文档存在，但role字段名拼写错误（大小写、字符不一致）
• 文档读取未完成时就执行字段读取操作

解决方案 #

1. 先验证Firestore数据的正确性

登录Firebase控制台，进入Firestore数据库：

• 检查users集合中是否存在当前登录用户UID对应的文档
• 确认文档内包含role字段，且字段名与代码中的role完全一致（区分大小写）

2. 修改StreamBuilder代码，增加安全判断

在读取字段前添加文档存在性、字段存在性的判断，避免直接调用get()触发报错：

StreamBuilder<User?>(
  stream: FirebaseAuth.instance.authStateChanges(),
  builder: (context, authSnapshot) {
    if (authSnapshot.hasData && authSnapshot.data != null) {
      return StreamBuilder<DocumentSnapshot>(
        stream: FirebaseFirestore.instance
            .collection("users")
            .doc(authSnapshot.data!.uid)
            .snapshots(),
        builder: (context, firestoreSnapshot) {
          // 处理加载状态
          if (firestoreSnapshot.connectionState == ConnectionState.waiting) {
            return const Material(
              child: Center(child: CircularProgressIndicator()),
            );
          }

          // 处理文档不存在的情况
          if (!firestoreSnapshot.hasData || !firestoreSnapshot.data!.exists) {
            return const Scaffold(
              body: Center(child: Text("用户信息未完善，请完成资料补充")),
            );
          }

          final userDoc = firestoreSnapshot.requireData;
          // 使用带默认值的get方法，避免字段不存在报错
          final role = userDoc.get('role', defaultValue: 'user');
          
          return role == 'admin' ? const AdminPage() : const Home();
        },
      );
    }
    return const LoginPage();
  },
);

3. 确保注册时同步创建用户文档

用户首次注册（或登录）时，必须在users集合中创建对应文档并写入role字段，示例代码：

Future<void> registerUser(String email, String password, String role) async {
  try {
    UserCredential userCredential = await FirebaseAuth.instance.createUserWithEmailAndPassword(
      email: email,
      password: password,
    );
    // 创建并写入用户文档
    await FirebaseFirestore.instance.collection("users").doc(userCredential.user!.uid).set({
      'email': email,
      'role': role, // 传入用户选择的角色（admin或普通用户）
      // 可添加其他用户信息字段
    });
  } catch (e) {
    print("注册错误: $e");
  }
}

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