如何用Firebase Java Admin SDK获取Firestore服务器时间并查询近24小时文档

首先明确说：Firebase Cloud Firestore Admin SDK不需要直接获取服务器时间就能实现你要的查询，而且有更简洁的方式来处理这个场景，下面给你详细说明：

核心思路 #

你用FieldValue.serverTimestamp()写入的lastUpdated字段，本质上存储的是Firestore服务器生成的UTC时间戳（类型为Timestamp）。而Admin SDK运行在后端环境，我们可以直接基于本地UTC时间计算过去24小时的时间点，用这个时间点来构造查询——只要你的服务器时间同步正常，这个计算结果和Firestore的服务器时间基准是完全一致的，查询结果会准确无误。

具体代码实现 #

先计算过去24小时的时间戳，再构造查询：

import com.google.cloud.Timestamp;
import com.google.firebase.firestore.Query;

// 计算UTC时间下的"过去24小时"时间点
Timestamp pastDay = Timestamp.now().minusHours(24);

// 构造查询：按lastUpdated降序，筛选出过去24小时内更新的文档
Query query = collectionRef
    .orderBy("lastUpdated", Query.Direction.DESCENDING)
    .whereGreaterThanOrEqualTo("lastUpdated", pastDay);

关键注意事项 #

• 字段名一致性：你的代码里同时出现了lastUpdated和last updated两个字段名，一定要确保和你实际写入文档的字段名完全一致，否则查询会返回空结果。
• 时间基准对齐：Timestamp.now()在Admin SDK中默认使用UTC时间，和FieldValue.serverTimestamp()的时间基准完全对齐，不需要额外处理时区转换。
• 服务器时间同步：如果你的服务器时间存在异常偏差，也可以通过Firestore事务间接获取服务器时间，但这种场景非常少见——绝大多数生产环境的服务器都会自动同步UTC时间，直接用本地计算的方式足够可靠。

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