Firebase函数本地测试凭证报错：部署正常本地运行失败如何解决？

这个错误是因为本地环境没有GCP的元数据服务器（metadata.google.internal），导致Admin SDK无法自动获取OAuth2访问令牌。下面是具体的解决方法，让代码同时兼容本地模拟器和生产环境：

1. 修正Admin SDK的初始化逻辑 #

我们需要让Admin SDK根据运行环境自动切换配置：

修改index.js中的Admin初始化代码：

"use strict";
const fooFunction = require("./foo");
const getUsersFunction = require("./getUsers");
const functions = require("firebase-functions");
const admin = require("firebase-admin");

// 根据环境初始化Admin SDK
if (process.env.FUNCTIONS_EMULATOR === "true") {
  // 本地模拟器环境：使用服务账号密钥初始化
  const serviceAccount = require("./service-account-key.json");
  admin.initializeApp({
    credential: admin.credential.cert(serviceAccount),
    // 替换为你的Firebase项目数据库URL（从控制台获取）
    databaseURL: "https://your-project-id.firebaseio.com"
  });
} else {
  // 生产环境：使用Firebase提供的默认配置
  admin.initializeApp(functions.config().firebase);
}

exports.fooFunction = functions.https.onRequest((req, res) => { fooFunction.handler(req, res); });
exports.getUsersFunction = functions.https.onRequest((req, res) => { getUsersFunction.handler(req, res, admin); });

如何获取服务账号密钥？ #

• 打开Firebase控制台，进入你的项目
• 点击左侧菜单的「设置」→「服务账号」
• 点击「生成新的私钥」，下载JSON文件，重命名为service-account-key.json，放在functions目录下
• 注意：不要将这个文件提交到Git仓库，可以添加到.gitignore中

2. 修正getUsersFunction.js的参数错误 #

你的代码中存在参数不匹配的问题：index.js传入的第一个参数是req，但getUsersFunction.js的handler第一个参数写的是ref，这会导致逻辑混乱，修正如下：

exports.handler = function (req, res, admin) {
  admin
    .auth()
    .listUsers(1000)
    .then(function (listUsersResult) {
      console.log(listUsersResult);
      res.send("done");
      return null;
    })
    .catch(function (error) {
      console.log("Error listing users:", error);
      // 记得返回错误响应，避免请求挂起
      res.status(500).send(`Error listing users: ${error.message}`);
    });
};

3. 本地运行前的准备 #

• 确保你已经安装了最新版的Firebase CLI：npm install -g firebase-tools
• 登录Firebase：firebase login
• 关联你的项目：firebase use your-project-id
• 安装依赖：在functions目录下运行npm install

4. 启动模拟器 #

运行命令：

firebase emulators:start --only=functions

现在你的getUsersFunction应该能在本地模拟器正常运行，同时部署到Firebase后也能保持正常工作。

内容的提问来源于stack exchange，提问作者Michael Nelles