Firestore Cloud Functions报错：firestore未定义，求解决提示

你遇到的ReferenceError: firestore is not defined错误，核心原因是没有在代码中正确初始化并引用Firebase Admin的Firestore实例，另外你的代码还有两个潜在问题需要修正，我一步步给你说明：

1. 初始化Firebase Admin并获取Firestore实例 #

在你的Cloud Functions代码顶部，需要先引入firebase-admin并完成初始化，然后获取Firestore的引用，这样firestore变量才会被正确定义：

const functions = require('firebase-functions');
const admin = require('firebase-admin');

// 初始化Admin SDK
admin.initializeApp();
// 获取Firestore实例
const firestore = admin.firestore();

// 你的updateUser函数写在这里
exports.updateUser = functions.firestore.document('Users/{userId}').onUpdate((change, context) => {
  // ... 后续代码
});

2. 修正QuerySnapshot的处理逻辑 #

你的代码中，where('name', '==', newValue).get()返回的是QuerySnapshot（一个查询结果的集合），而不是单个文档快照，直接调用doc.data()会触发错误。你需要先判断查询是否返回了有效文档，再获取第一个匹配的文档：

return firestore.collection('Projects')
  .where('name', '==', newValue).get()
  .then(querySnapshot => {
    if (querySnapshot.empty) {
      console.log('没有找到匹配的项目');
      return null;
    }
    // 获取第一个匹配的文档
    const targetDoc = querySnapshot.docs[0];
    console.log('项目ID:', targetDoc.id);
    return targetDoc.id;
  })
  .catch(error => {
    console.error('查询项目失败:', error);
    throw error;
  });

3. 确保函数返回Promise #

Cloud Functions的异步触发器（比如onUpdate）需要返回一个Promise，否则函数会在异步操作完成前被强制终止。你需要把整个异步逻辑的Promise链返回出去，保证操作完成：

exports.updateUser = functions.firestore.document('Users/{userId}').onUpdate((change, context) => {
  const newValue = change.after.data().currentProject;
  console.log("Project changed to - " + newValue);
  const previousValue = change.before.data().currentProject;
  console.log("from - " + previousValue);

  // 返回整个Promise链，确保异步操作完成
  return firestore.collection('Projects')
    .where('name', '==', newValue).get()
    .then(querySnapshot => {
      if (querySnapshot.empty) {
        console.log('没有找到匹配的项目');
        return null;
      }
      const targetDoc = querySnapshot.docs[0];
      console.log('项目ID:', targetDoc.id);
      return targetDoc.id;
    })
    .catch(error => {
      console.error('查询项目失败:', error);
      throw error;
    });
});

关于依赖的说明 #

你的package.json里的依赖配置是没问题的，firebase-admin和firebase-functions的版本完全支持Firestore操作，不需要额外添加新依赖。

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