如何配置Firebase Authentication返回INVALID_CREDENTIALS替代具体错误？

直接用Firebase客户端SDK调用邮箱密码认证时，没办法修改Firebase Authentication返回的原始错误响应——像EMAIL_NOT_FOUND、INVALID_PASSWORD这类具体错误是Firebase认证服务器直接返回的，客户端没有权限配置或覆盖这些网络层面的响应内容。

要解决这个问题，你需要加一层中间代理，用Firebase Cloud Functions封装认证请求：客户端不再直接调用Firebase Auth的SDK方法，转而调用你自己写的云函数，由云函数内部处理认证逻辑并返回自定义错误。

具体实现步骤 #

1. 编写云函数（后端）

先确保你已经初始化了Firebase Cloud Functions项目，安装Firebase Admin SDK：

npm install firebase-admin

然后创建处理登录请求的云函数：

const functions = require("firebase-functions");
const admin = require("firebase-admin");
const fetch = require("node-fetch");

admin.initializeApp();

// 从Firebase项目设置中获取你的API Key，可配置到云函数环境变量
const FIREBASE_API_KEY = functions.config().firebase.api_key;

exports.signInWithEmail = functions.https.onCall(async (data) => {
  const { email, password } = data;

  try {
    // 调用Firebase Auth的REST API验证登录
    const response = await fetch(
      `https://identitytoolkit.googleapis.com/v1/accounts:signInWithPassword?key=${FIREBASE_API_KEY}`,
      {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({
          email,
          password,
          returnSecureToken: true
        })
      }
    );

    const result = await response.json();

    // 处理Auth返回的错误
    if (result.error) {
      const errorMsg = result.error.message;
      if (["EMAIL_NOT_FOUND", "INVALID_PASSWORD"].includes(errorMsg)) {
        throw new functions.https.HttpsError("invalid-argument", "Invalid credentials");
      } else {
        throw new functions.https.HttpsError("internal", errorMsg);
      }
    }

    // 返回登录成功后的token信息
    return {
      idToken: result.idToken,
      refreshToken: result.refreshToken,
      expiresIn: result.expiresIn
    };
  } catch (err) {
    // 统一抛出云函数标准错误
    if (err instanceof functions.https.HttpsError) {
      throw err;
    }
    throw new functions.https.HttpsError("internal", "登录失败，请稍后重试");
  }
});

2. 修改客户端代码（React）

替换原来的signInWithEmailAndPassword调用，改为调用云函数：

import { getFunctions, httpsCallable } from "firebase/functions";
import { signInWithCustomToken, getAuth } from "firebase/auth";

// 初始化云函数和Auth实例
const functions = getFunctions();
const auth = getAuth();
const signInWithEmail = httpsCallable(functions, "signInWithEmail");

// 登录逻辑
try {
  setFirebaseError("");
  const response = await signInWithEmail({ email: values.email, password: values.password });
  // 用云函数返回的自定义token登录
  await signInWithCustomToken(auth, response.data.idToken);
} catch (err) {
  setFirebaseError(err.message || "登录失败");
}

为什么客户端直接调用不行？ #

Firebase客户端SDK是直接和认证服务器通信，服务器返回的错误响应是固定的系统内容，Firebase没有开放配置自定义原始响应的入口——你之前的UI层处理只是在前端屏蔽了具体错误，但网络请求的原始响应还是Firebase服务器返回的，这部分没法通过客户端代码修改。

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