如何使用firebase-admin通过displayName查询用户，判断用户名是否已存在？

你之前通过getUsers传入displayName查询的写法确实无法生效，该接口仅支持uid、email、phoneNumber三类查询标识符，传入其他字段会被自动忽略。针对displayName唯一性校验的需求，最优实现方式如下：

最优实现方案 #

无需额外搭建独立数据库，直接复用Firebase配套的Firestore/实时数据库存储displayName和uid的映射关系即可，配合事务操作可以保证数据一致性，单条查询效率为O(1)，完全满足注册场景的性能要求。

1. 搭建用户名映射存储 #

在Firestore中创建专门的集合usernames，集合下的每个文档ID直接对应用户名（建议统一转为小写存储，规避大小写不同导致的重复用户名漏洞），文档内仅存储对应用户的uid字段即可。

2. 注册前校验用户名是否存在 #

直接查询对应用户名的文档是否存在即可，代码示例：

// 统一转为小写匹配，避免大小写问题
const targetUsername = username.toLowerCase()
const usernameDoc = admin.firestore().collection('usernames').doc(targetUsername)
const docSnapshot = await usernameDoc.get()
if (docSnapshot.exists) {
  console.log("User already exists.")
  // 抛出用户名已存在的业务错误即可
  return
}

3. 事务保证操作原子性 #

为了避免多个用户同时抢注同一个用户名的并发冲突，需要把Auth用户创建和用户名映射写入的操作放到事务中执行，保证两个操作要么同时成功要么同时失败：

let userRecord
try {
  userRecord = await admin.firestore().runTransaction(async (t) => {
    const doc = await t.get(usernameDoc)
    if (doc.exists) {
      throw new Error('username already taken')
    }
    // 先创建Auth用户
    const newUser = await admin.auth().createUser({
      displayName: username,
      // 其他用户配置：邮箱、密码、手机号等
    })
    // 写入用户名映射
    t.set(usernameDoc, { uid: newUser.uid })
    return newUser
  })
} catch (err) {
  console.log('注册失败：', err.message)
}

不推荐的替代方案 #

• 全量拉取Auth用户列表匹配：用户量超过100之后接口响应延迟会大幅上升，还容易触发Admin SDK的调用频率限制，完全不适合生产环境。
• 自定义声明存储用户名：实现复杂度更高，查询效率远低于直接查Firestore文档，没有落地价值。

注意：如果有用户名修改的需求，修改时要同步删除旧的用户名映射文档，写入新的用户名映射文档，同样要通过事务保证操作原子性。

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