如何在TypeScript版Firebase云函数中从Firestore指定文档获取字段？

我来帮你搞定这个问题！你遇到的报错是因为TypeScript版的Firebase Admin SDK和Dart版的Firestore API在获取文档快照的方式上有差异——Dart里你可能习惯用snapshot来拿文档数据，但在TypeScript的Admin SDK中，DocumentReference并没有snapshot这个属性，要单次获取文档内容得用get()异步方法，而onSnapshot是用来监听文档实时变化的，不是干这个的。

下面是修正后的完整代码，关键改动都标了注释：

const db = admin.firestore();
const fcm = admin.messaging();

export const sendToDevice = functions.firestore
  .document('messages/{groupChatId}/{chatId}/{message}')
  .onCreate(async (snapshot) => {
    const message = snapshot.data();
    if (message != null) {
      const querySnapshot = await db
        .collection('messages')
        .doc(message.idTo)
        .collection('tokens')
        .get();

      // 修正点1：用get()异步获取文档快照，必须加await等待结果
      const personFromSnapshot = await db.collection('messages').doc(message.idFrom).get();
      // 修正点2：先检查文档是否存在，避免空文档导致的错误
      if (!personFromSnapshot.exists) {
        console.log('发送者对应的文档不存在');
        return null;
      }
      // 修正点3：从快照的data()方法中提取nickname字段
      const personFromData = personFromSnapshot.data();
      // 用可选链和默认值处理字段不存在的情况
      const senderNickname = personFromData?.nickname || '未知发送者';

      const tokens = querySnapshot.docs.map((snap) => snap.id);
      const payload: admin.messaging.MessagingPayload = {
        notification: {
          // 用模板字符串拼接更简洁
          title: `New Message from ${senderNickname}!`,
          body: message.content,
          icon: 'your-icon-url',
          click_action: 'FLUTTER_NOTIFICATION_CLICK'
        }
      };

      return fcm.sendToDevice(tokens, payload);
    } else {
      return null;
    }
  });

再给你划几个重点：

• 异步操作必须加await：get()是异步方法，不加await的话你拿到的是一个Promise对象，根本不是文档快照，自然拿不到字段。
• 一定要检查文档是否存在：如果message.idFrom对应的文档被删除了，personFromSnapshot.exists会是false，这时候直接返回可以避免后续报错。
• 处理字段缺失的情况：用personFromData?.nickname || '未知发送者'可以防止nickname字段不存在时出现undefined，保证通知标题正常显示。
• 模板字符串更友好：把原来的字符串拼接改成ES6模板字符串，代码可读性更高，也不容易写错。

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