如何在Firebase Authentication中检查邮箱是否存在？

核心思路 #

Firebase Admin SDK提供了getUserByEmail()方法，调用该方法如果抛出UserNotFoundException，则说明邮箱不存在；如果能成功返回用户对象，就代表邮箱已在Auth系统中存在。基于这个逻辑就能实现你要的遍历判断需求。

依赖配置（Maven为例） #

先把Firebase Admin SDK引入项目：

<dependency>
    <groupId>com.google.firebase</groupId>
    <artifactId>firebase-admin</artifactId>
    <version>9.2.0</version> <!-- 建议用最新稳定版 -->
</dependency>

完整实现代码 #

初始化Admin SDK #

先完成SDK初始化（应用启动时执行一次即可）：

import com.google.firebase.FirebaseApp;
import com.google.firebase.FirebaseOptions;
import com.google.firebase.auth.FirebaseAuth;
import com.google.firebase.auth.FirebaseAuthException;
import com.google.firebase.auth.UserRecord;

import java.io.FileInputStream;
import java.io.IOException;

public class FirebaseEmailChecker {
    static {
        try {
            // 替换成你的服务账号密钥文件路径
            FileInputStream serviceAccount = new FileInputStream("serviceAccountKey.json");

            FirebaseOptions options = new FirebaseOptions.Builder()
                    .setCredentials(com.google.firebase.auth.FirebaseCredentials.fromCertificate(serviceAccount))
                    .build();

            FirebaseApp.initializeApp(options);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    // 判断邮箱是否不存在于Firebase Auth
    private static boolean emailNotExistsInDatabase(String email) {
        try {
            // 尝试通过邮箱获取用户
            UserRecord user = FirebaseAuth.getInstance().getUserByEmail(email);
            // 能拿到用户说明邮箱存在，返回false
            return false;
        } catch (FirebaseAuthException e) {
            // 捕获用户未找到的异常，说明邮箱不存在
            if (e.getErrorCode().equals("user-not-found")) {
                return true;
            }
            // 其他异常（比如权限问题、网络故障）按需处理
            e.printStackTrace();
            return false;
        }
    }

    // 遍历邮箱列表的示例逻辑
    public static void processEmailList(String[] emailList) {
        for (String email : emailList) {
            if (emailNotExistsInDatabase(email)) {
                // 邮箱不存在时执行后续操作
                System.out.println("邮箱 " + email + " 不存在，执行后续业务...");
                // 这里添加你的业务代码，比如创建用户、发送通知等
            } else {
                System.out.println("邮箱 " + email + " 已存在，跳过");
            }
        }
    }

    public static void main(String[] args) {
        String[] testEmails = {"test1@example.com", "test2@example.com", "existing_user@example.com"};
        processEmailList(testEmails);
    }
}

注意事项 #

• 服务账号密钥文件（serviceAccountKey.json）要从Firebase控制台的项目设置里下载，确保路径正确。
• 服务账号需要拥有Firebase Auth Admin角色，否则会触发权限异常。
• 批量检查大量邮箱时，要注意Firebase的API调用速率限制，建议分批处理避免被限流。
• 除了user-not-found，其他异常（比如无效邮箱格式、网络错误）要单独处理，别误判成“邮箱不存在”。

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