如何利用Firebase Functions检测Firestore集合的文档新增？

当然可以！Firebase Cloud Functions正好提供了对应的能力来监听Firestore集合里的文档新增事件，完全能解决你检测People集合中Person1这类文档被添加的需求。

一、用Cloud Functions的onCreate触发器实现 #

Firestore的Cloud Functions有个onCreate触发器，专门针对新文档创建的场景。不管是手动在Firebase控制台添加的Person1，还是通过后端/前端代码写入的文档，只要是People集合下的新增文档，都会触发这个函数。

代码示例（Node.js） #

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

// 监听People集合下所有新增文档
exports.onPersonAdded = functions.firestore
  .document("People/{personId}")
  .onCreate((snap, context) => {
    // 获取新增文档的内容
    const newPerson = snap.data();
    // 获取新增文档的ID（比如这里就是Person1）
    const personId = context.params.personId;

    // 打印日志，你可以替换成自己的业务逻辑（比如发通知、同步数据等）
    functions.logger.info(`新文档「${personId}」已添加到People集合：`, newPerson);
    
    // 函数需要返回一个Promise或null，这里返回null表示执行完成
    return null;
  });

• 如果你只需要监听特定ID的文档（比如仅关注Person1），只需把触发器路径改成People/Person1即可，这样只有当Person1这个文档被创建时才会触发函数。
• 部署这个函数后，只要People集合有新文档加入，函数就会自动执行你定义的逻辑。

二、其他替代方案（如果无法使用Cloud Functions） #

如果因为离线需求、权限限制等原因没法用Cloud Functions，还有这些方法可以检测文档新增：

• 客户端实时监听：在前端代码中使用Firestore的实时监听API，直接在客户端监听People集合的变化，当有文档添加时触发本地逻辑。示例（Web端）：

import { collection, onSnapshot } from "firebase/firestore";
import { db } from "./your-firebase-config";

const peopleCollection = collection(db, "People");
// 监听集合的实时变化
onSnapshot(peopleCollection, (snapshot) => {
  snapshot.docChanges().forEach((change) => {
    if (change.type === "added") {
      console.log("检测到新增文档：", change.doc.data());
      // 在这里执行你的前端逻辑，比如更新UI、弹出提示等
    }
  });
});

• 定时批量检查：如果对实时性要求不高，可以写一个定时任务（比如用Cloud Functions的pubsub.schedule），定期查询People集合，对比上次检查的文档列表来找出新增项。不过这种方法效率较低，适合非实时的统计类需求。

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