如何在Firebase中防止用户名重复，确保数据库用户名唯一？

核心思路 #

Firebase邮箱密码认证仅管理邮箱与密码，不内置用户名唯一性校验。要实现该功能，需结合Firebase Realtime Database或Cloud Firestore，通过原子性操作和安全规则避免并发冲突，确保用户名全局唯一。

步骤1：设计数据库结构 #

以Cloud Firestore为例，创建usernames集合，用用户名作为文档ID，存储对应用户的UID：

// 集合结构示例
usernames/{username}: {
  uid: "用户的Firebase UID"
}

利用Firestore文档ID的唯一性特性，直接通过文档是否存在判断用户名是否被占用。

步骤2：前端预校验（优化用户体验） #

用户输入用户名后，先查询usernames集合做前置检查：

async function checkUsernameExists(username) {
  const docRef = firebase.firestore().collection('usernames').doc(username);
  const docSnap = await docRef.get();
  return docSnap.exists;
}

// 使用示例
const usernameInput = document.getElementById('username').value;
const isTaken = await checkUsernameExists(usernameInput);
if (isTaken) {
  alert('该用户名已被占用，请更换');
  return;
}

⚠️ 前端校验仅为提升体验，必须配合后端安全规则，防止恶意绕过。

步骤3：原子性创建用户与绑定用户名 #

通过批量写入保证用户创建和用户名绑定的原子性，避免出现用户创建成功但用户名被抢占的情况：

async function signUp(email, password, username) {
  const db = firebase.firestore();
  const batch = db.batch();

  // 二次校验用户名（避免并发场景下的冲突）
  const usernameDoc = db.collection('usernames').doc(username);
  const usernameSnap = await usernameDoc.get();
  if (usernameSnap.exists) {
    throw new Error('用户名已被占用');
  }

  // 创建Firebase Auth用户
  const userCredential = await firebase.auth().createUserWithEmailAndPassword(email, password);
  const uid = userCredential.user.uid;

  // 批量写入：绑定用户名到UID，同时在用户集合存储基础信息
  batch.set(usernameDoc, { uid });
  batch.set(db.collection('users').doc(uid), {
    email,
    username,
    createdAt: firebase.firestore.FieldValue.serverTimestamp()
  });

  // 执行批量操作，要么全部成功，要么全部失败
  await batch.commit();
}

步骤4：设置数据库安全规则（关键） #

通过Firestore安全规则，确保只有合法用户才能绑定用户名，且用户名只能被绑定一次：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // 控制usernames集合的读写权限
    match /usernames/{username} {
      allow read: if true; // 允许所有人查询用户名是否存在
      allow create: if request.auth != null && request.resource.data.uid == request.auth.uid;
      allow update, delete: if request.auth != null && resource.data.uid == request.auth.uid;
    }

    // 控制users集合的读写权限
    match /users/{uid} {
      allow read: if request.auth.uid == uid;
      allow create: if request.auth.uid == uid;
      allow update, delete: if request.auth.uid == uid;
    }
  }
}

步骤5：修改用户名的校验逻辑 #

若允许用户后续修改用户名，同样需遵循原子性操作：

async function updateUsername(newUsername) {
  const user = firebase.auth().currentUser;
  if (!user) throw new Error('用户未登录');

  const db = firebase.firestore();
  const batch = db.batch();
  const oldUsernameDoc = db.collection('usernames').doc(user.displayName); // 假设旧用户名存在displayName中
  const newUsernameDoc = db.collection('usernames').doc(newUsername);

  // 检查新用户名是否被占用
  const newUsernameSnap = await newUsernameDoc.get();
  if (newUsernameSnap.exists) {
    throw new Error('新用户名已被占用');
  }

  // 批量操作：删除旧用户名绑定、添加新用户名绑定、更新用户文档
  batch.delete(oldUsernameDoc);
  batch.set(newUsernameDoc, { uid: user.uid });
  batch.update(db.collection('users').doc(user.uid), { username: newUsername });

  // 同步更新Auth用户的displayName（可选）
  await user.updateProfile({ displayName: newUsername });

  await batch.commit();
}

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