如何在Firebase Cloud Functions中使用新版模块化Firestore API

firebase-admin/app 初始化生成的Admin SDK应用实例，与客户端SDK的firebase/firestore 完全不兼容，这就是你抛出Cannot read properties of undefined (reading 'getProvider')错误的直接原因。

两类SDK的定位和边界非常清晰，不存在跨包兼容设计：

• firebase-admin是服务端专属SDK，面向Cloud Functions、自建服务端等Node.js环境，内置服务账号特权鉴权，不受客户端安全规则约束。截至11.0.0版本，Admin SDK未提供和客户端v9一致的函数式模块化API，所有服务的调用仍沿用命名空间风格的接口设计。
• firebase/firestore属于客户端Web SDK，仅能接收由客户端包firebase/app初始化生成的应用实例，传入Admin SDK生成的实例时，内部无法读取客户端SDK专属的getProvider属性，就会触发你看到的类型错误。

根据你的业务场景二选一即可，禁止跨包混用实例。

方案1：使用Admin SDK（常规服务端场景首选） #

这是Cloud Functions环境的官方推荐方案，自带管理员权限，无需手动传入配置，运行时会自动读取平台注入的服务账号凭据，性能和权限适配都最优。
初始化代码示例：

// 所有依赖均从firebase-admin包下引入，不要混装客户端firebase包的同名方法
const { initializeApp, applicationDefault } = require('firebase-admin/app');
const { getFirestore } = require('firebase-admin/firestore');

initializeApp({
  credential: applicationDefault()
});

// 获取Firestore实例，后续直接用该实例调用服务端API
const db = getFirestore();

注意：Admin SDK的Firestore API为服务端专属写法，例如新增文档调用db.collection('集合名').add(数据)，和客户端v9的addDoc(collection(db, '集合名'), 数据)函数式写法不通用。

方案2：强制使用客户端v9函数式API（仅特殊场景使用） #

仅当你需要模拟普通用户身份、严格受Firestore安全规则约束的场景下才用该方案，此时完全不需要引入firebase-admin包，全部逻辑使用客户端SDK实现。
首先安装客户端SDK依赖：

npm install firebase

初始化代码示例：

// 所有方法均从客户端firebase包引入
const { initializeApp } = require('firebase/app');
const { getFirestore } = require('firebase/firestore');

// 必须传入Web端Firebase应用配置，无法使用服务端凭据
const clientFirebaseConfig = {
  apiKey: "你的Web应用API Key",
  authDomain: "你的项目认证域名",
  projectId: "你的项目ID",
  // 补全其余Web端配置项
};

const clientApp = initializeApp(clientFirebaseConfig);
const db = getFirestore(clientApp);

注意：该方案下SDK身份等同于普通Web客户端，所有读写操作都会被安全规则校验，没有服务端管理员特权，不适合常规的后端逻辑开发。

截至目前，Firebase官方没有公布Admin SDK对齐客户端v9函数式API的迭代计划，服务端SDK的迭代优先级为稳定性、服务端场景适配，不会和客户端API做完全对齐，不需要等待相关能力更新。

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