如何在Firebase规则中检查并避免重复邮箱写入

要实现写入时校验邮箱不重复的需求，Firebase实时数据库的规则本身不支持直接遍历所有/emails子节点来对比邮箱（这种操作效率极低且规则语法不支持循环遍历），正确的方案是通过**反向索引（Reverse Index）**来实现快速校验，下面是具体的实现步骤：

1. 调整数据结构，新增反向索引 #

我们需要添加一个/emails_by_email节点，用已存在的邮箱作为节点键（key），值可以存储对应的订阅者ID，这样能通过邮箱直接快速查询是否已存在，结构示例：

{
  "emails": {
    "id1": { "email": "banana@gmail.com" },
    "id2": { "email": "watermelon@gmail.com" }
  },
  "emails_by_email": {
    "banana@gmail.com": "id1",
    "watermelon@gmail.com": "id2"
  }
}

2. 编写实时数据库规则 #

接下来修改规则，同时对/emails和/emails_by_email两个节点做校验，确保只有邮箱不存在时才能写入，并且保证索引和主数据的一致性：

{
  "rules": {
    // 主订阅数据节点
    "emails": {
      "$emailId": {
        ".read": "auth != null",
        ".write": "
          // 1. 待写入的邮箱必须是合法字符串
          newData.child('email').isString() &&
          // 2. 反向索引中不存在该邮箱（核心校验逻辑）
          !root.child('emails_by_email').child(newData.child('email').val()).exists()
        "
      }
    },
    // 反向索引节点，保证只能和主数据同步更新
    "emails_by_email": {
      "$email": {
        ".write": "
          // 写入索引时，必须对应主数据节点的邮箱，且索引之前不存在
          newData.val() === root.child('emails').child(newData.val()).child('email').val() &&
          !root.child('emails_by_email').child($email).exists()
        ",
        ".read": "auth != null"
      }
    }
  }
}

规则核心逻辑解释： #

• !root.child('emails_by_email').child(newData.child('email').val()).exists()：直接通过反向索引节点检查待写入的邮箱是否已存在，不存在则允许写入主数据节点，这一步是高效的，因为是直接通过键查询，不需要遍历。
• 对/emails_by_email的规则限制：避免有人单独篡改索引，确保索引只能和主数据节点同步创建，保证数据的一致性。

3. 客户端实现原子写入 #

为了保证主数据和索引同时写入成功（原子性，要么都成功，要么都失败），客户端需要使用Firebase的update()方法进行批量更新，示例代码（JavaScript）：

const db = firebase.database();
// 生成唯一的订阅者ID
const newSubscriberId = db.ref().child('emails').push().key;
const newEmail = "orange@gmail.com";

// 构建批量更新对象
const updates = {};
updates[`/emails/${newSubscriberId}`] = { email: newEmail };
updates[`/emails_by_email/${newEmail}`] = newSubscriberId;

// 执行原子更新
db.ref().update(updates)
  .then(() => {
    console.log("订阅成功，邮箱已添加");
  })
  .catch((error) => {
    console.error("订阅失败：邮箱已存在或权限不足", error);
  });

为什么不能直接遍历/emails节点？ #

Firebase实时数据库的规则是声明式语法，不支持循环、遍历这类命令式操作；另外，遍历所有子节点会随着订阅者数量增多导致性能急剧下降，反向索引是官方推荐的解决唯一性校验的标准方案。

内容的提问来源于stack exchange，提问作者Lorenzo Case Del Rosario