使用Firebase模拟器调用Callable Function时遇FirebaseError: Unauthenticated报错

生产环境下调整Google Cloud Console的方案很多，但开发阶段用函数模拟器遇到onCall认证错误的情况确实容易踩坑——onRequest能正常HTTP调用，onCall用SDK调用就报"FirebaseError: Unauthenticated"，核心原因是onCall默认依赖Firebase认证上下文，而模拟器环境下需要正确配置本地认证模拟和SDK指向。

以下是具体解决步骤：

1. 确认Firebase CLI状态 #

确保本地CLI已登录并关联正确项目：

• 执行firebase login验证登录状态，未登录则完成授权
• 执行firebase use --add选择并关联你的Firebase项目ID

2. 启动带认证模拟器的服务 #

onCall函数依赖认证服务，必须同时启动函数和认证模拟器：

• 直接启动命令：firebase emulators:start --only functions,auth
• 或者通过firebase.json配置固定端口（避免端口冲突）：

  {
    "emulators": {
      "auth": {
        "port": 9099
      },
      "functions": {
        "port": 5001
      },
      "ui": {
        "enabled": true
      }
    }
  }
  

  配置后执行firebase emulators:start即可，UI界面默认在http://localhost:4000，方便管理测试用户。

3. 客户端SDK完全指向本地模拟器 #

不管是Web还是Node.js客户端，必须同时配置函数和认证模拟器的地址，否则SDK会默认请求生产环境：

Web SDK示例 #

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

const auth = getAuth();
const functions = getFunctions();

// 关联本地函数模拟器
connectFunctionsEmulator(functions, "localhost", 5001);
// 关联本地认证模拟器
if (window.location.hostname === "localhost") {
  auth.useEmulator("http://localhost:9099");
}

Node.js客户端示例 #

const { initializeApp } = require("firebase/app");
const { getAuth, signInWithEmailAndPassword } = require("firebase/auth");
const { getFunctions, connectFunctionsEmulator } = require("firebase/functions");

const app = initializeApp({
  // 填入你的Firebase项目配置（可以从控制台复制）
  apiKey: "YOUR_API_KEY",
  authDomain: "YOUR_PROJECT_ID.firebaseapp.com",
  projectId: "YOUR_PROJECT_ID"
});

const auth = getAuth(app);
const functions = getFunctions(app);

connectFunctionsEmulator(functions, "localhost", 5001);
auth.useEmulator("http://localhost:9099");

4. 创建并登录测试用户 #

onCall需要有效的认证上下文，必须在模拟器中创建测试用户并登录：

• 通过模拟器UI（http://localhost:4000/auth）手动创建邮箱/密码用户
• 或者在客户端代码中自动登录：

  // Web/Node.js通用
  await signInWithEmailAndPassword(auth, "test@example.com", "test123456");
  

5. 检查onCall函数的认证逻辑 #

如果函数中有自定义认证校验，确保逻辑正确：

exports.myCallableFunc = functions.https.onCall(async (data, context) => {
  // 基础认证检查
  if (!context.auth) {
    throw new functions.https.HttpsError("unauthenticated", "用户未登录");
  }

  // 如果有角色校验，确保测试用户满足条件
  // const userRole = await getUserRole(context.auth.uid);
  // if (!userRole) {
  //   throw new functions.https.HttpsError("permission-denied", "无权限");
  // }

  return { message: "调用成功" };
});

常见坑点 #

• 不要在本地环境混用生产环境的SDK配置，必须确保所有服务指向模拟器
• 启动模拟器后等待几秒，确认函数和认证服务都加载完成再发起调用
• 如果使用Firebase Admin SDK调用onCall，同样需要配置指向模拟器，并使用模拟器的认证用户ID

内容的提问来源于stack exchange，提问作者Jonatas Eduardo