Firebase第二代云函数调用报错：默认Firebase应用不存在及初始化问题

问题场景 #

部署多个第二代Firebase Cloud Function后，调用addCustomClaim函数时，日志抛出错误：'the default firebase app does not exist'。相关代码如下：

原函数代码 #

exports.addCustomClaim = onCall({secrets: [privateKey], ...params},
    async (data) => {
      const admin = instantiateFirebase().admin;
      const user = await admin.auth().getUserByEmail(data.data.email);
      console.log("adding claims ", data.data.claims, "to", user.uid);
      try {
        await admin.auth().setCustomUserClaims(user.uid, data.data.claims);
        if (data.data.logoutUser) {
          console.log("logging out user", user.uid);
          await admin.auth().revokeRefreshTokens(user.uid);
        }
        return await {
          message: ` Success!claims ${Object.keys(data.data.claim)}
        have been set on ${data.data.email}`,
        };
      } catch (err) {
        return {error: err, user: user.uid};
      }
    });

原初始化代码 #

const instantiateFirebase = ()=>{
  const privateKey= defineSecret("PRIVATE_KEY");
  const clientEmail = defineString("CLIENT_EMAIL");
  const projectId = defineString("PROJECT_ID");
  const databaseURL = defineString("DATABASE_URL");
  console.log("instantiating firebase");
  if(admin.apps.length===0){
    console.log("no app");
  initializeApp({
    credential: admin.credential.cert({
      privateKey: privateKey.value().replace(/\\n/g, "\n"),
      projectId: projectId.value(),
      clientEmail: clientEmail.value(),
    }),
    databaseURL: databaseURL.value(),
  });}

  const db = admin.firestore();
  const realtime = admin.database();
  console.log("done");
  return {db, admin, realtime};
};
export {instantiateFirebase};

错误原因 #

1. 秘密值获取时机错误：defineSecret和defineString返回的是异步取值对象，直接调用.value()会得到未解析的Promise，导致初始化App时传入的凭证参数无效，App初始化失败。
2. 初始化逻辑同步执行缺陷：instantiateFirebase是同步函数，在秘密值还未获取完成时就尝试初始化App，最终导致默认App未成功创建。
3. 第二代函数参数结构误用：第二代onCall的参数是request对象，数据存储在request.data中，原代码使用data.data会导致数据读取异常（虽不是直接报错原因，但会引发后续逻辑问题）。
4. 手动初始化冗余：第二代Cloud Function运行在GCP环境中，Admin SDK可自动通过元数据服务获取默认凭证，无需手动传入cert参数。

解决方案 #

步骤1：简化Admin SDK初始化 #

移除手动凭证配置，让SDK自动处理认证，将初始化代码放在模块顶层，确保函数执行前App已初始化完成：

import { initializeApp } from 'firebase-admin/app';
import { getAuth } from 'firebase-admin/auth';
import { getFirestore } from 'firebase-admin/firestore';
import { getDatabase } from 'firebase-admin/database';

// 第二代环境下自动获取默认凭证，无需手动配置
const app = initializeApp();

// 导出Admin服务实例
export const admin = {
  auth: getAuth,
  firestore: getFirestore,
  database: getDatabase
};
export const db = getFirestore(app);
export const realtime = getDatabase(app);

步骤2：修正函数代码逻辑 #

调整onCall参数结构，修正数据读取方式，并修复拼写错误：

import { onCall } from 'firebase-functions/v2/https';
import { admin } from './firebase-init'; // 导入初始化模块

exports.addCustomClaim = onCall({ secrets: ['PRIVATE_KEY'] }, async (request) => {
  const { email, claims, logoutUser } = request.data;
  
  try {
    const user = await admin.auth().getUserByEmail(email);
    console.log(`adding claims ${JSON.stringify(claims)} to ${user.uid}`);
    
    await admin.auth().setCustomUserClaims(user.uid, claims);
    
    if (logoutUser) {
      console.log(`logging out user ${user.uid}`);
      await admin.auth().revokeRefreshTokens(user.uid);
    }
    
    return {
      message: `Success! Claims ${Object.keys(claims)} have been set on ${email}`
    };
  } catch (err) {
    return { error: err.message, userId: user?.uid };
  }
});

额外说明 #

• 如果需要本地测试，可通过设置GOOGLE_APPLICATION_CREDENTIALS环境变量指向服务账号JSON文件，SDK会自动读取凭证。
• 移除原代码中冗余的instantiateFirebase函数，避免重复初始化逻辑引发的问题。

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