Firestore(4.13.0)内部未处理错误：Firebase Functions查询时触发TypeError

问题分析 #

你碰到的这个错误，核心原因是在Firebase云函数环境里误用了客户端firebase SDK来访问Firestore。客户端SDK是给浏览器、移动应用这类前端场景设计的，而云函数属于服务端环境，必须用专门的firebase-admin SDK来操作Firestore，混用就会触发这类内部依赖加载的异常。

修复步骤 #

1. 安装firebase-admin依赖
   先在你的函数项目根目录执行安装命令：

   npm install firebase-admin --save
   

2. 替换为admin SDK初始化Firestore
   把原来的客户端SDK调用代码，换成admin SDK的正确写法：

   // 引入并初始化admin SDK
   const admin = require('firebase-admin');
   admin.initializeApp();
   
   // 获取Firestore实例
   const db = admin.firestore();
   
   // 调整查询代码
   let accountRef = db.collection('accounts'); // 无需开头的斜杠
   accountRef.where("_username", "==", username).get().then((snapshot) => {
       // 你的业务处理逻辑
       if (snapshot.empty) {
           console.log('未找到匹配的账号');
           return;
       }
       snapshot.forEach(doc => {
           console.log(doc.id, '=>', doc.data());
           // 处理文档数据
       });
   }).catch(err => {
       console.log('查询失败', err);
   });
   

额外提示 #

• 云函数里调用admin.initializeApp()不需要传入配置参数，Firebase会自动通过云函数的环境变量读取项目配置。
• 集合路径不需要加开头的斜杠，直接写accounts就可以，虽然加斜杠也能运行，但前者更符合规范。
• 确保云函数的服务账号（系统自动生成）拥有Firestore的读写权限，你可以在Firebase控制台的项目设置 > 服务账号里检查权限配置。

内容的提问来源于stack exchange，提问作者Marc-Antoine Roberge