NextJS使用Firebase Admin SDK调用collection()参数错误如何解决？

你混淆了**Firebase Admin SDK（服务端专用）和Firebase Web V9 SDK（客户端专用）**的API体系，两类SDK的接口不兼容，是报错的核心原因。

1. 初始化代码错误 #

你使用客户端Web SDK的getFirestore()方法导出的实例，并不是Admin SDK的合法Firestore实例，Admin SDK初始化后需直接从admin实例获取Firestore对象。
修复后的初始化代码：

import admin from 'firebase-admin';

if (!admin.apps.length) {
  admin.initializeApp({
    credential: admin.credential.cert({
      projectId: process.env.NEXT_PUBLIC_PROJECT_ID,
      // 注意：环境变量中存储的私钥默认会把换行转义为\n，需要替换为真实换行才能正常认证
      privateKey: process.env.FIREBASE_PRIVATE_KEY.replace(/\\n/g, '\n'),
      clientEmail: process.env.FIREBASE_CLIENT_EMAIL
    })
  });
}

const db = admin.firestore();
export default db;

2. 数据库调用代码错误 #

@firebase/firestore包下的collection、getDocs等方法是客户端Web SDK专属API，不能传入Admin SDK的Firestore实例调用。Admin SDK使用专属的链式调用API，无需引入客户端的模块化方法。
修复后的接口代码：

import db from '@/lib/firebase-admin';

export default async (_, res) => {
  const sites = [];

  const querySnapshot = await db.collection('sites').get();
  querySnapshot.forEach((doc) => {
    // 原有push写法会把id和文档属性摊平为数组独立元素，需封装为对象保证结构正确
    sites.push({
      id: doc.id,
      ...doc.data()
    });
  });

  res.status(200).json(sites);
};

• Firebase Admin SDK仅可在Next.js的服务端代码（API路由、getServerSideProps等服务端运行的逻辑）中使用，禁止在客户端组件/页面中导入，否则会泄露服务端私钥引发安全风险。
• 不要在同一个服务端逻辑中混合导入@firebase/firestore等客户端SDK包和firebase-admin包，避免API混用错误。

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