Firestore模拟器中Firebase Admin无法查找文档问题排查

我之前也踩过一模一样的坑！核心问题在于Cloud Functions的Admin SDK默认不会自动连接本地Firestore模拟器，而你的客户端代码应该已经通过配置指向了本地模拟器，导致两边访问的是完全不同的Firestore实例——客户端读的是本地模拟器里的数据库，而Cloud Functions默认读的是线上的Firestore，自然找不到你在本地创建的文档。

下面是具体的解决步骤：

1. 给Admin Firestore添加本地模拟器配置 #

修改你的db.js文件，在初始化Admin之后，加入环境判断逻辑，当运行在模拟器环境时，强制Admin连接本地Firestore模拟器：

const admin = require('firebase-admin');
admin.initializeApp();

let db = admin.firestore();

// 检测是否运行在Functions模拟器环境（模拟器会自动设置这个环境变量）
if (process.env.FUNCTIONS_EMULATOR === 'true') {
  // 配置连接本地Firestore模拟器，端口默认是8080（如果你的模拟器端口修改过要对应调整）
  db.settings({
    host: 'localhost:8080',
    ssl: false
  });
}

function getUserData(email, returnDoc) {
  console.log(`imtp-db.getUserData: ${email}`);
  let docRef = db.collection("Users").doc(email);
  return docRef.get().then(function (doc) {
    console.log(`doc.exists: ${doc.exists}`);
    if (doc.exists) {
      console.log("Document data:", doc.data());
      return returnDoc(undefined, doc);
    } else {
      return returnDoc("User not found.", doc);
    };
  }).catch(function (error) {
    return returnDoc("Error getting user.", doc);
  });
};
exports.getUserData = getUserData;

2. 额外排查项 #

• 确认本地Firestore模拟器中确实存在目标文档：打开Firebase模拟器控制台（默认地址http://localhost:4000/firestore），查看Users集合下的文档ID是否和你传入的email完全一致（Firestore文档ID大小写敏感，注意不要有拼写或大小写差异）。
• 重启模拟器：修改代码后，需要重启firebase emulators:start才能让新配置生效。

调整后，Cloud Functions就会和客户端一样访问本地Firestore模拟器，应该就能正常找到文档了！

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