Flutter Firebase登录时如何判断users集合指定uid用户是否存在

原有逻辑问题说明 #

• 逻辑颠倒：新用户才需要初始化空favItems字段，老用户写入空数组会直接覆盖已有的收藏数据，导致用户收藏内容丢失
• 冗余重复：两次写入操作除favItems外其余字段完全一致，没必要分开写全量字段
• 路径错误：不需要遍历usersUids数组取索引，登录成功后可直接获取当前用户的uid作为文档ID
• 全量覆盖风险：直接调用set()方法不带merge参数会清空文档内其他未写入的自定义字段

正确实现步骤 #

1. 前置依赖确认 #

先确认pubspec.yaml中已引入相关依赖：

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^2.15.0
  firebase_auth: ^4.10.0
  cloud_firestore: ^4.13.0

2. 完整实现代码 #

import 'package:cloud_firestore/cloud_firestore.dart';
import 'package:firebase_auth/firebase_auth.dart';

final FirebaseFirestore _db = FirebaseFirestore.instance;
final FirebaseAuth _auth = FirebaseAuth.instance;

Future<void> handleUserLogin(User user1) async {
  // 获取当前用户文档引用
  final userDocRef = _db.collection('users').doc(user1.uid);
  final userDocSnapshot = await userDocRef.get();
  final date = DateTime.now(); // 可根据需求替换为注册时间/服务器时间

  if (!userDocSnapshot.exists) {
    // 新用户：写入全量字段，初始化空收藏数组
    await userDocRef.set({
      "displayName": user1.displayName,
      "email": user1.email,
      "uid": user1.uid,
      "date": date,
      "photoUrl": user1.photoURL,
      "lastSignIn": DateTime.now(),
      "favItems": [],
    });
  } else {
    // 老用户：仅更新可变字段，不覆盖原有收藏和其他自定义字段
    await userDocRef.set({
      "displayName": user1.displayName,
      "email": user1.email,
      "photoUrl": user1.photoURL,
      "lastSignIn": DateTime.now(),
    }, SetOptions(merge: true));
  }
}

// 调用示例：登录成功后触发
void loginTrigger() async {
  // 此处替换为实际登录逻辑，支持手机号/邮箱/第三方登录等场景
  UserCredential userCredential = await _auth.signInWithEmailAndPassword(
    email: "user@example.com",
    password: "yourpassword",
  );
  if (userCredential.user != null) {
    await handleUserLogin(userCredential.user!);
  }
}

3. 可选优化建议 #

• 时间字段可以替换为FieldValue.serverTimestamp()，使用Firebase服务器时间避免本地时间不准的问题
• 如果必须保留老用户写入favItems的需求，建议先判断字段是否存在再初始化，避免覆盖已有数据：

  // 老用户兼容favItems初始化示例
  if(userDocSnapshot.data()?.containsKey('favItems') != true) {
    await userDocRef.update({"favItems": []});
  }
  

• 可以在FirebaseAuth.instance.authStateChanges()监听器中直接调用处理逻辑，自动处理每次登录的用户数据同步

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