如何使用Python检查Firebase实时数据库中是否已存在指定邮箱的用户

刚好之前做项目的时候也碰到过一模一样的需求——在新增用户到Firebase Realtime DB前，先校验邮箱有没有被注册过。结合你给出的数据结构，我整理了两种可行的实现方案，其中一种是高效推荐版，另一种适合小数据量临时用：

前提准备 #

首先得确保你已经安装了Firebase的Python SDK，没装的话先跑这个命令：

pip install firebase-admin

然后用你的服务账号密钥初始化SDK，这个密钥可以在Firebase控制台的「项目设置」→「服务账号」里下载。

方案一：创建邮箱索引（推荐，高效查询） #

Firebase Realtime DB的查询效率依赖于数据结构，直接遍历所有用户在数据量上来后会特别慢。所以最好提前建一个邮箱到用户ID的映射索引，比如在数据库里新增一个email_to_user节点，结构像这样：

{
  "email_to_user": {
    "test@gmail.com": "321"
  },
  "users": {
    "321": {
      "email": "test@gmail.com",
      "phone": "123",
      "id": "321"
    }
  }
}

这样查询的时候直接定位到邮箱对应的节点，效率是O(1)的。

实现代码 #

import firebase_admin
from firebase_admin import credentials
from firebase_admin import db

# 初始化SDK
cred = credentials.Certificate('path/to/your/serviceAccountKey.json')
firebase_admin.initialize_app(cred, {
    'databaseURL': 'https://your-database-url.firebaseio.com/'
})

def check_email_exists(target_email):
    # 获取邮箱索引节点的引用
    email_index_ref = db.reference('email_to_user')
    # 查询目标邮箱对应的用户ID
    existing_user_id = email_index_ref.child(target_email).get()
    # 如果返回值不为None，说明邮箱已存在
    return existing_user_id is not None

# 调用示例
if check_email_exists("test@gmail.com"):
    print("这个邮箱已经被注册过啦！")
else:
    print("邮箱可用，可以创建新用户~")

新增用户时同步更新索引 #

记得在创建新用户的时候，同时把邮箱和用户ID的映射写到索引里，不然索引会失效：

def create_new_user(user_data):
    # 先检查邮箱是否存在
    if check_email_exists(user_data['email']):
        raise ValueError("该邮箱已被注册")
    
    # 把新用户写入users节点
    users_ref = db.reference('users')
    new_user_ref = users_ref.push()
    new_user_ref.set(user_data)
    
    # 更新邮箱索引
    email_index_ref = db.reference('email_to_user')
    email_index_ref.child(user_data['email']).set(new_user_ref.key)

方案二：遍历所有用户（仅适合小数据量） #

如果你的用户数据很少，或者暂时不想改数据库结构，可以用这种遍历的方式，但数据量一大就会很慢，因为要把所有用户数据拉到本地遍历：

def check_email_exists_without_index(target_email):
    users_ref = db.reference('users')
    all_users = users_ref.get()
    
    if all_users:
        # 遍历每个用户的数据，对比邮箱
        for _, user_info in all_users.items():
            if user_info.get('email') == target_email:
                return True
    return False

# 调用示例
if check_email_exists_without_index("test@gmail.com"):
    print("邮箱已存在！")
else:
    print("邮箱未被使用~")

注意事项 #

• 一定要检查你的Firebase数据库规则，确保服务账号有读取users和email_to_user节点的权限，不然会报错。
• 推荐始终用方案一，哪怕现在数据量小，后期用户多了也不用重构代码。

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