部署在Firebase的Next.js应用中Firebase-admin初始化失败

问题描述 #

使用firebase-tools的Web框架选项将Next.js应用部署到Firebase Hosting后，调用firebase-admin获取数据时出现错误：

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

本地环境下初始化代码可正常运行，但部署后失效。

核心原因分析 #

1. 环境变量未同步：本地.env文件中的变量不会自动同步到Firebase Hosting，部署后变量缺失导致初始化失败。
2. 私有密钥格式错误：NEXT_FIREBASE_PRIVATE_KEY中的换行符在环境变量存储时会被转义为\n字符串，直接使用会导致证书验证失败。
3. 初始化时机问题：模块级别提前执行初始化代码时，可能环境变量还未完成加载，导致初始化不生效。

解决方案 #

1. 在Firebase控制台配置环境变量 #

登录Firebase控制台，进入目标项目的设置 > 环境变量，添加以下变量：

• NEXT_FIREBASE_CLIENT_EMAIL
• NEXT_PUBLIC_FIREBASE_PROJECT_ID
• NEXT_FIREBASE_PRIVATE_KEY（复制完整私钥，保留所有换行符）
• NEXT_PUBLIC_FIREBASE_DATABASE_URL
• NEXT_PUBLIC_STORAGE_BUCKET

2. 修正firebase-admin初始化代码 #

修改firebase/firebaseAdminInit.ts，处理私有密钥的换行符问题，并确保初始化逻辑可靠：

import admin from 'firebase-admin';

let adminApp: admin.app.App | null = null;

export function getFirebaseAdminApp() {
  if (adminApp) {
    return adminApp;
  }

  // 处理私有密钥的换行符转义问题
  const privateKey = process.env.NEXT_FIREBASE_PRIVATE_KEY?.replace(/\\n/g, '\n');
  if (!privateKey) {
    throw new Error('NEXT_FIREBASE_PRIVATE_KEY环境变量未配置');
  }

  adminApp = admin.initializeApp({
    credential: admin.credential.cert({
      clientEmail: process.env.NEXT_FIREBASE_CLIENT_EMAIL as string,
      projectId: process.env.NEXT_PUBLIC_FIREBASE_PROJECT_ID as string,
      privateKey: privateKey
    }),
    databaseURL: process.env.NEXT_PUBLIC_FIREBASE_DATABASE_URL as string,
    storageBucket: process.env.NEXT_PUBLIC_STORAGE_BUCKET as string
  });

  return adminApp;
}

3. 调整Firestore实例的初始化时机 #

避免在模块级别提前初始化Firestore实例，改为在函数内部调用初始化逻辑，确保环境变量已加载：
修改lib/repository/products.ts：

import { getFirelord, getFirestore, getDocs } from "firelord";
import { ProductsMetaType } from "./dtoModels";
import { productToDomain } from "../domain/Products";
import { getFirebaseAdminApp } from "../../firebase/firebaseAdminInit";

export async function GetAllProducts() {
  // 在函数内部初始化Firebase Admin和Firestore实例
  const app = getFirestore(getFirebaseAdminApp());
  const productFl = getFirelord<ProductsMetaType>(app, 'Products');

  const docs = await getDocs(productFl.collection())
    .then(qSnapshot => qSnapshot.docs.map(docSnapshot => docSnapshot.data()))
    .then(dtoArr => dtoArr.map(productToDomain));
  
  return docs;
}

4. 验证firebase.json配置 #

确保firebase.json中的Web框架配置正确：

{
  "hosting": {
    "source": ".",
    "frameworksBackend": {
      "region": "us-central1" // 替换为你的项目所在区域
    }
  }
}

部署验证 #

重新部署应用：

firebase deploy --only hosting

测试接口或服务器组件，确认firebase-admin初始化正常，数据可正常读取。

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