Firebase云函数返回最后文档快照时触发栈溢出错误求助

返回最后一个文档快照用于分页时，出现以下错误：

Unhandled error RangeError: Maximum call stack size exceeded

相关代码 #

获取最后快照的函数：

function lastSnapshot(querySnapshot) {
  return querySnapshot.docs[querySnapshot.docs.length - 1];
}

并行查询与返回逻辑：

const [sponsored, timed, popular, all] = await Promise.all([
  sponsoredQuery.get(),
  timedQuery.get(),
  popularQuery.get(),
  allQuery.get(),
]);

const lastVenue = lastSnapshot(all);

return {
  sections: processedResults,
  lastVenue: lastVenue,
};

查询定义：

const venueBaseRef = firestore
  .collection("venues")
  .where("city_id", "==", city)
  .where("active", "==", true);

const allQuery = venueBaseRef.orderBy("updated_at", "desc").limit(15);

快照日志（部分内容） #

QueryDocumentSnapshot {
  _fieldsProto: {
    ...SNAPSHOT FIELDS
  },
  _ref: DocumentReference {
    _firestore: Firestore {
      _settings: [Object],
      _settingsFrozen: true,
      _serializer: [Serializer],
      _projectId: 'XXXXXXXXXX',
      _databaseId: '(default)',
      registeredListenersCount: 0,
      bulkWritersCount: 0,
      _backoffSettings: [Object],
      _clientPool: [ClientPool],
      _gax: [Object]
    },
    _path: QualifiedResourcePath {
      segments: [Array],
      projectId: 'XXXXXXXXXX',
      databaseId: '(default)'
    },
    _converter: {
      toFirestore: [Function: toFirestore],
      fromFirestore: [Function: fromFirestore]
    }
  },
  _serializer: Serializer {
    createReference: [Function (anonymous)],
    createInteger: [Function (anonymous)],
    allowUndefined: false
  },
  _readTime: Timestamp { _seconds: 1703684076, _nanoseconds: 567040000 },
  _createTime: Timestamp { _seconds: 1702043723, _nanoseconds: 945695000 },
  _updateTime: Timestamp { _seconds: 1703683586, _nanoseconds: 824383000 }
}

原因分析 #

直接返回QueryDocumentSnapshot实例会触发JSON序列化死循环。快照对象内部包含大量循环引用（比如_ref中的Firestore实例又引用了序列化器、连接池等对象，层层嵌套），Cloud Function在尝试将返回值序列化为JSON时，会不断遍历这些循环引用，最终导致栈溢出。

解决方案 #

不要直接返回原生快照对象，而是提取分页所需的可序列化数据，以下两种方案可选：

方案1：仅返回分页游标信息（推荐）

只返回下一页查询必需的标记字段，减少数据传输：

function lastSnapshot(querySnapshot) {
  const doc = querySnapshot.docs[querySnapshot.docs.length - 1];
  if (!doc) return null;
  // 返回排序字段和文档ID，用于下一页的startAfter查询
  return {
    id: doc.id,
    updated_at: doc.get('updated_at') // 对应orderBy指定的排序字段
  };
}

后续分页查询可使用：

const nextPageQuery = allQuery.startAfter(lastVenue.updated_at, lastVenue.id);

方案2：返回文档完整数据+ID

如果需要同时返回文档内容，用data()获取纯数据对象：

function lastSnapshot(querySnapshot) {
  const doc = querySnapshot.docs[querySnapshot.docs.length - 1];
  if (!doc) return null;
  return {
    id: doc.id,
    ...doc.data()
  };
}

以上两种方式返回的对象都是纯JSON可序列化的，不会触发循环引用问题。

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