SvelteKit部署Firebase Hosting后Firestore Admin SDK调用失败（500错误）

问题背景 #

本地运行SvelteKit应用时，后端load函数能通过Firebase Admin SDK正常读取Firestore数据；但部署到Firebase Hosting后页面返回500错误，云端日志显示：

FirebaseAppError: The default Firebase app does not exist. Make sure you call initializeApp() before using any of the Firebase services.

将load函数改为仅返回空对象时页面正常加载，确认问题与Admin SDK的初始化逻辑相关。

问题根源 #

本地开发时直接通过serviceAccountKey.json初始化Admin SDK可以正常工作，但在Firebase Hosting的云端环境中，存在两个核心问题：

1. 模块加载时机导致初始化代码未被正确执行，admin.apps.length判断失效
2. 云端环境无需手动传入serviceAccount文件，Google Cloud会自动提供默认凭据，手动传入反而可能引发加载异常

修正方案 #

1. 适配环境的Firebase Admin初始化代码 #

// firebase admin 初始化
import admin from 'firebase-admin';

let firestoreAdmin;

// 封装初始化逻辑，确保实例就绪
function initFirebase() {
  if (admin.apps.length === 0) {
    if (process.env.NODE_ENV === 'development') {
      // 本地开发使用serviceAccount文件
      import('./serviceAccountKey.json').then(serviceAccount => {
        admin.initializeApp({
          credential: admin.credential.cert(serviceAccount.default)
        });
        firestoreAdmin = admin.firestore();
      });
    } else {
      // 云端环境自动使用默认凭据，无需传入serviceAccount
      admin.initializeApp();
      firestoreAdmin = admin.firestore();
    }
  } else {
    firestoreAdmin = admin.firestore();
  }
}

initFirebase();

export { firestoreAdmin };

2. 优化后的load函数（增加错误排查） #

// svelte +page.server.js load函数
import { firestoreAdmin } from "$lib/firebaseAdmin.js";

export async function load() {
    let pivots = {};
    let fuel;
    let settings;
    let errorMsg = "no error";

    try {
        // 先确认Firestore实例已初始化
        if (!firestoreAdmin) {
            throw new Error("Firestore Admin实例未完成初始化");
        }

        // 并行请求提升效率
        const [pivotsSnap, fuelSnap, settingsSnap] = await Promise.all([
            firestoreAdmin.collection('pivots').get(),
            firestoreAdmin.doc('inputs/fuel').get(),
            firestoreAdmin.doc('settings/settings').get()
        ]);

        pivotsSnap.forEach(doc => {
            pivots[doc.id] = doc.data();
        });
        fuel = fuelSnap.data();
        settings = settingsSnap.data();

    } catch (error) {
        errorMsg = error.message;
        console.error("数据加载失败:", error);
    }

    return { pivots, fuel, settings, error: errorMsg };
}

核心优化点 #

• 环境适配：区分本地与云端环境的初始化逻辑，云端利用Google Cloud默认凭据，避免serviceAccount文件的加载问题
• 初始化保证：通过封装函数确保Admin SDK在获取Firestore实例前完成初始化，解决模块加载时机导致的实例未就绪问题
• 性能优化：用Promise.all并行执行多个Firestore请求，减少等待时间

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