Node.js中Firestore查询集合近24小时文档失败问题

两个问题的核心原因分别是：

• 第一次范围查询无结果：你写入timestamp字段时调用了new Date().toJSON()，存入Firestore的是ISO格式的字符串类型，但查询时传入的start/end是JavaScript的Date对象，Firestore范围查询严格匹配值类型，类型不一致时不会命中任何文档。你提供的控制台截图也能验证该问题：
  
• startAt游标报错：Firestore要求使用startAt/endAt/startAfter/endBefore这类游标方法前，必须先通过orderBy()指定和游标值对应的排序字段，你没有加对应的orderBy约束，直接传游标值就会触发参数不匹配的错误。

1. 调整timestamp字段的存储方式（推荐） #

不建议用字符串存储时间，优先使用Firestore原生的Timestamp类型，SDK支持直接传入JavaScript Date对象，会自动转换为原生Timestamp存储，查询、排序、时间运算的兼容性和性能都更好。
注意：CollectionReference没有直接的set方法，新增文档用add，指定文档ID时用doc(文档ID).set，修改写入代码如下：

// 新增文档示例
admin.firestore().collection('users').add({
  // 其余业务字段
  timestamp: new Date() // 去掉.toJSON()调用，直接传Date对象
})

// 指定文档ID写入/更新示例
admin.firestore().collection('users').doc('自定义文档ID').set({
  // 其余业务字段
  timestamp: new Date()
}, { merge: true })

2. 编写正确的范围查询代码 #

查询最近24小时文档直接用where做范围过滤即可，逻辑简单不需要用游标：

const end = new Date();
const start = new Date(end.getTime() - 24 * 60 * 60 * 1000); // 计算24小时前的时间点

const usersSnapshot = await admin
  .firestore()
  .collection('users')
  .where('timestamp', '>', start)
  .where('timestamp', '<', end)
  .orderBy('timestamp', 'desc') // 可选配置，按时间倒序返回，最新文档在前
  .get();

// 解析查询结果
const userList = usersSnapshot.docs.map(doc => ({
  id: doc.id,
  ...doc.data()
}));

Firestore默认会为所有单字段创建升序、降序索引，上述查询不需要手动配置索引即可运行。

如果你确实需要使用游标实现分页查询，必须先对timestamp字段加orderBy约束，和游标字段一一对应：

const start = new Date(Date.now() - 24 * 60 * 60 * 1000);
const usersSnapshot = await admin
  .firestore()
  .collection('users')
  .orderBy('timestamp') // 必须先按游标对应的字段排序
  .startAt(start)
  .get();

存量历史数据兼容方案（不推荐长期使用） #

如果你已经存入了大量字符串格式的timestamp，暂时不想做数据迁移，可以在查询时把时间对象转为和存储格式一致的ISO字符串，保证类型匹配即可查到结果：

const end = new Date();
const start = new Date(end.getTime() - 24 * 60 * 60 * 1000);

// 转为和存储一致的ISO字符串格式
const startStr = start.toJSON();
const endStr = end.toJSON();

const usersSnapshot = await admin
  .firestore()
  .collection('users')
  .where('timestamp', '>', startStr)
  .where('timestamp', '<', endStr)
  .get();

该方案仅做临时兼容，字符串存储时间无法使用Firestore内置的时间运算、安全规则时间校验能力，长期使用建议迁移为原生Timestamp类型。

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