Next.js集成Firebase认证异常：未使用过的邮箱注册触发auth/email-already-in-use错误

看起来你遇到的是Firebase Auth里一个容易踩坑的细节问题，我来帮你拆解分析并给出修复方案：

核心问题根源 #

首先要明确：Firebase Auth中，只要调用createUserWithEmailAndPassword成功创建过用户，不管邮箱是否验证，这个邮箱都会被标记为「已被使用」。哪怕你没在控制台用户列表里看到（比如用户创建后被删除、或者处于临时未同步状态），也会触发这个错误。另外你的代码里还有个容易被忽略的小问题——重复初始化Firebase App，这可能导致状态异常。

一步步修复方案 #

1. 先确认邮箱是否真的已存在于Firebase用户池

打开Firebase控制台 → 认证 → 用户页面，搜索你测试用的邮箱：

• 如果确实存在：如果是测试账号直接删除后重试；如果是真实用户，引导走「找回密码」流程而非重新注册。
• 如果不存在：那大概率是重复初始化Firebase App导致的状态混乱，继续看下一步。

2. 修复Firebase App重复初始化问题

在Next.js里，每次调用注册函数都重新初始化Firebase App是不合理的，会引发各种奇怪的状态问题。我们改成单例模式初始化：

先创建单独的Firebase配置文件（比如firebase/config.ts）：

import { initializeApp, getApp, getApps } from "firebase/app";
import { getAuth } from "firebase/auth";
import { getFirestore } from "firebase/firestore";

const fireconfig = {
  // 你的Firebase配置信息
};

// 单例模式：只有当没有已初始化的App时才创建新实例
const app = !getApps().length ? initializeApp(fireconfig) : getApp();
const auth = getAuth(app);
const db = getFirestore(app);

export { auth, db };

然后在你的注册组件里直接导入这个单例实例，去掉重复初始化的代码：

import { auth, db } from "../firebase/config"; // 路径根据你的项目调整
// 其他导入...

const handleRegistration = async (registerData: FormData) => {
  setIsLoading(true);
  try {
    // 去掉这里的initializeApp和getAuth，直接用导入的auth实例
    if (registerData.password.length < 8) {
      setPasswordErrorMessage("密码长度不能少于8个字符");
      return;
    }
    if (passwordErrorMessage) {
      setPasswordErrorMessage("");
    }

    // 只要走到这一步，说明邮箱是未被注册的（否则会直接进入catch）
    const userCredential: any = await createUserWithEmailAndPassword(
      auth,
      registerData.email,
      registerData.password
    );

    // 直接发送验证邮件，不需要判断emailVerified（新创建的用户肯定未验证）
    await sendEmailVerification(userCredential.user);
    toast({
      title: "验证邮件已发送，请查收邮箱完成验证",
      status: "success",
      position: "top",
      duration: null,
      isClosable: true,
    });

    // 写入用户数据到Firestore
    const userDocRef = doc(db, "users", userCredential.user.uid);
    const userDocSnapshot = await getDoc(userDocRef);
    if (!userDocSnapshot.exists()) {
      const userData = {
        firstName: registerData.firstName,
        lastName: registerData.lastName,
        email: registerData.email,
      };
      await setDoc(userDocRef, userData);
    }

    router.push("/login");

  } catch (error: any) {
    if (error.code === "auth/email-already-in-use") {
      setErrorMessage("该邮箱已被注册，请尝试找回密码或更换邮箱");
    } else {
      // 处理其他错误（比如网络问题、密码不符合规则等）
      setErrorMessage(error.message || "注册失败，请稍后重试");
    }
  } finally {
    setIsLoading(false);
  }
};

3. 额外优化建议

• 开启Firebase Auth的自动清理功能：在控制台→认证→设置→用户操作里，开启「自动删除未验证用户」，设置7天左右的期限，避免未验证的测试账号堆积干扰测试。
• 错误提示更精准：针对auth/email-already-in-use的提示，可以引导用户去验证邮箱或找回密码，而不是模糊的“用户名已被占用”。

备注：内容来源于stack exchange，提问作者Farhan