Firebase server-timestamp显示时间与实际正确时间偏差问题解决

我尝试使用firebase-server-timestamp向用户展示订单提交时间，过程中遇到时间显示错误的问题：比如当前实际时间为12:30，但timestamp仅显示12:15，该问题是什么原因导致的？

相关代码与复现情况 #

Android 实体类代码 #

data class MyTimestampPOJO(
    val date: Timestamp = Timestamp.now(), // 错误，时间早了15分钟
)

数据库截图（实际提交时间为12:50，而非显示的12:35） #

Firestore 写入数据代码 #

suspend fun sendEmail() {
    val data = MyTimestampPOJO()
    FirebaseFirestore.getInstance().collection("orders_service").add(data).await()
}

云函数读取数据代码 #

export const dbOrderServiceOnCreated = functions
   .region("europe-west1")
   .firestore
   .document("orders_service/{id}")
   .onCreate((snapshot, context) => {
        const data = snapshot.data()
        const date = convertTimestampToDate(data.date)

        return Promise.resolve()
    })

function convertTimestampToDate(stamp: firestore.Timestamp): string {
    return new Intl.DateTimeFormat('de-De', { year: 'numeric', month: 'numeric', day: 'numeric', hour: 'numeric', minute: 'numeric' }).format(stamp.toDate())
}

测试说明：我是在firebase-emulator中进行的测试，手机时间确认正确，且按照server-timestamp的设计逻辑，本就不该受设备时间影响。

问题修复方案 #

存在两处错误导致时间偏移：

1. 实体类时间戳字段写法错误
   原错误写法：

data class MyTimestampPOJO(val date: Timestamp = Timestamp.now())

正确写法应为：

data class MyTimestampPOJO(@ServerTimestamp val date: Timestamp? = null)

原因是带@ServerTimestamp注解的Timestamp字段会在文档写入数据库时自动填充：

该注解用于标记时间戳字段，使其自动填充服务器时间。如果写入的POJO中被@ServerTimestamp注解的字段值为null，它会被服务器生成的时间戳自动替换。

2. 云函数区域配置错误
   每个云函数（可调用函数和事件触发函数）都可以配置独立的区域，开发者需要将函数区域指定为自己对应的区域：比如之前函数区域被自动分配到了美国，但实际服务区域位于欧洲，就会出现时间偏差。

export const dbOrderServiceOnCreated = functions
    .region("europe-west1") // 非常重要!!!!
    .firestore
    ...

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