Next.js 15.2.2及以上版本使用Turbopack时访问Firebase Admin的问题解析

2025-04-28 10:01:29作者：彭桢灵Jeremy

Next.js，前端开发的新篇章，赋能您构建高性能、可扩展的现代web应用。这不仅仅是一个框架，它是未来互联网界面开发的基石。通过 Serverless 和 Static Site Generation 的无缝集成，Next.js 让您的网页兼具动态交互与闪电般的加载速度。热重载和自动优化特性让开发者体验无比流畅。无论是复杂的单页应用，还是数据驱动的新闻站点，Next.js 都能轻松应对，将React的力量发挥到极致。拥抱Next.js，即是拥抱高效、简洁以及无限可能的 web 开发新世界。

项目地址：https://gitcode.com/gh_mirrors/nex/next.js

问题背景

在Next.js 15.2.2及后续版本中，当开发者使用Turbopack作为开发服务器时，尝试访问Firebase Admin SDK会遇到模块解析问题。具体表现为在代码中导入firebase-admin模块后，调用initializeApp()方法时会抛出"TypeError: Cannot read properties of undefined (reading 'INTERNAL')"错误。

问题现象

开发者在使用以下代码时会出现问题：

import * as firebase from 'firebase-admin';
const result = firebase.initializeApp();

当使用Turbopack运行开发服务器时，firebase变量解析为undefined，导致后续方法调用失败。但在以下情况下却能正常工作：

使用Next.js 15.1.7或更早版本
不使用Turbopack运行开发服务器
执行生产环境构建

技术分析

这个问题源于Turbopack对模块导入方式的优化处理。在较新版本的Turbopack中，它会自动将星号导入(import * as)重写为具名导入。这种优化在大多数情况下能提高性能，但对于Firebase Admin SDK这种特殊结构的模块却会导致问题。

Turbopack实际上将代码转换为：

import {initializeApp} from 'firebase-admin';
const result = firebase.initializeApp();

这种转换破坏了Firebase Admin SDK的模块结构，因为Firebase Admin SDK的设计需要保持特定的模块层次关系。

解决方案

根据Firebase官方文档的建议，正确的导入方式应该是直接导入所需的子模块。以下是推荐的解决方案：

import { getApps, initializeApp } from 'firebase-admin/app';
import { credential, firestore } from 'firebase-admin';

const existingApps = getApps();
if (!existingApps.length) {
  initializeApp({
    credential: credential.cert(firebaseConfig),
  });
}
return firestore();