Firestore按最后修改时间筛选集合的实现问题

哈哈，这个问题我前段时间刚踩过一模一样的坑！确实Firestore的内置updateTime没法直接用来做查询——它属于文档元数据，只能在获取DocumentSnapshot之后通过getUpdateTime()拿到，没法写到查询条件里。而手动添加自定义_lastModifiedAt字段时，又很容易触发云端函数的递归调用，给你两个实用的解决思路：

方案一：修复云端函数的递归问题 #

核心思路是在onWrite函数里加判断，跳过因更新_lastModifiedAt本身而触发的函数调用，避免递归。

举个Node.js云端函数的示例：

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

exports.syncLastModified = functions.firestore
  .document('your-collection/{docId}')
  .onWrite(async (change, context) => {
    const beforeDoc = change.before;
    const afterDoc = change.after;

    // 新创建文档，直接设置_lastModifiedAt
    if (!beforeDoc.exists) {
      return afterDoc.ref.set({
        _lastModifiedAt: admin.firestore.FieldValue.serverTimestamp()
      }, { merge: true });
    }

    const beforeData = beforeDoc.data();
    const afterData = afterDoc.data();

    // 检查是否仅_lastModifiedAt字段发生了变化
    const isOnlyLastModifiedChange = Object.keys(afterData).every(key => {
      if (key === '_lastModifiedAt') return true;
      return JSON.stringify(afterData[key]) === JSON.stringify(beforeData[key]);
    });

    if (isOnlyLastModifiedChange) {
      // 是我们自己更新字段触发的调用，直接返回避免递归
      return null;
    }

    // 其他情况，更新_lastModifiedAt
    return afterDoc.ref.update({
      _lastModifiedAt: admin.firestore.FieldValue.serverTimestamp()
    });
  });

这个逻辑里，我们会判断如果这次触发只有_lastModifiedAt字段改变，就直接跳过后续操作，完美避免递归。

方案二：利用快照做增量查询（实时监听场景） #

如果你的需求是实时监听某个时间点之后的文档修改，而不是一次性查询，其实可以结合快照的updateTime来做增量监听：

// 先获取初始时间点的快照
const initialSnapshot = await db.collection('your-collection').get();
const lastUpdateTime = initialSnapshot.docs[initialSnapshot.docs.length - 1].updateTime;

// 监听这个时间点之后的变化
const unsubscribe = db.collection('your-collection')
  .orderBy('__name__') // 必须指定排序字段，这里用文档ID兜底
  .startAfter(lastUpdateTime)
  .onSnapshot(snapshot => {
    snapshot.docChanges().forEach(change => {
      console.log('修改的文档:', change.doc.data());
    });
  });

不过注意，这种方法只适用于实时监听，没法用来做一次性的历史数据筛选，还是方案一的自定义字段更通用。

最终实现效果 #

搞定函数递归问题后，你就可以像用普通字段一样，通过_lastModifiedAt来筛选某个时间点之后修改的文档了：

const targetTime = new Date('2024-05-01T00:00:00');
const query = db.collection('your-collection')
  .where('_lastModifiedAt', '>', targetTime)
  .orderBy('_lastModifiedAt');

const snapshot = await query.get();
snapshot.forEach(doc => {
  console.log(doc.id, '=>', doc.data());
});

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