如何在Firestore中同步Firebase Authentication用户并避免重复（暂不使用Cloud Functions）

嘿，我刚好处理过类似的需求，给你几个不需要依赖Cloud Functions的可行方案，既能避免重复创建用户记录，又能灵活添加自定义属性：

方案1：登录成功后用setDoc合并写入（最推荐） #

每次用户登录成功后，直接用Firestore的setDoc方法，并加上merge: true选项。这个方法的好处是：如果用户文档已经存在，只会更新你指定的字段（不会覆盖原有自定义属性）；如果不存在，就创建新文档。完美解决重复记录的问题。

示例代码（假设你用的是Web SDK）：

// Google登录逻辑
const signInWithGoogle = async () => {
  const provider = new GoogleAuthProvider();
  try {
    const result = await signInWithPopup(auth, provider);
    const user = result.user;
    
    // 写入/更新Firestore用户文档
    await setDoc(
      doc(db, "users", user.uid), // 用Auth的UID作为文档ID，确保唯一
      {
        email: user.email,
        displayName: user.displayName,
        photoURL: user.photoURL,
        lastLoginAt: new Date() // 可以添加登录时间这类动态属性
        // 这里可以直接加你的自定义属性，比如role: 'user'
      },
      { merge: true } // 关键！合并模式，避免覆盖已有数据
    );
    console.log("用户信息已同步到Firestore");
  } catch (error) {
    console.error("登录或同步失败:", error);
  }
};

方案2：先检查文档是否存在，再决定创建/更新 #

如果你想更明确地控制流程，可以先查询Firestore中是否存在该用户的文档，不存在就创建，存在则更新必要字段（比如最后登录时间）。

示例代码：

const syncUserToFirestore = async (user) => {
  const userDocRef = doc(db, "users", user.uid);
  const userDoc = await getDoc(userDocRef);
  
  if (!userDoc.exists()) {
    // 首次登录，创建新文档
    await setDoc(userDocRef, {
      email: user.email,
      displayName: user.displayName,
      photoURL: user.photoURL,
      createdAt: new Date(),
      // 初始化自定义属性
      favoriteTheme: "light",
      notificationsEnabled: true
    });
    console.log("新用户文档已创建");
  } else {
    // 用户已存在，仅更新动态字段
    await updateDoc(userDocRef, {
      lastLoginAt: new Date()
    });
    console.log("用户登录时间已更新");
  }
};

// 在登录成功后调用
const signInWithGoogle = async () => {
  const provider = new GoogleAuthProvider();
  try {
    const result = await signInWithPopup(auth, provider);
    await syncUserToFirestore(result.user);
  } catch (error) {
    console.error("操作失败:", error);
  }
};

方案3：利用Auth状态监听自动同步 #

如果用户可能通过刷新页面、自动登录等方式进入应用，可以用Firebase Auth的onAuthStateChanged监听，一旦检测到用户登录状态，就自动同步到Firestore。这个方法能覆盖所有登录场景，包括页面初始化时的自动登录。

示例代码：

// 页面初始化时监听Auth状态
onAuthStateChanged(auth, async (user) => {
  if (user) {
    // 用户已登录，同步到Firestore
    await setDoc(
      doc(db, "users", user.uid),
      {
        email: user.email,
        displayName: user.displayName,
        lastLoginAt: new Date()
      },
      { merge: true }
    );
  }
});

重要安全提醒 #

别忘了设置Firestore安全规则，确保只有用户自己能修改自己的文档，防止恶意操作：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId} {
      allow read, write: if request.auth != null && request.auth.uid == userId;
    }
  }
}

后续切换到Cloud Functions的兼容 #

现在用这些方案，后续如果想迁移到Cloud Functions，只需要把同步逻辑移到Auth的onCreate触发器里即可，现有Firestore的文档结构完全兼容，不需要做太多改动。

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