Firestore数组更新报错：调用update()仍触发FieldValue.serverTimestamp()异常

这个错误的核心不是你用了update()方法，而是你试图添加到数组中的Product对象包含了FieldValue.serverTimestamp()类型的字段——而Firestore的arrayUnion操作不允许数组元素中存在FieldValue类型的值。

具体来说，你的Product类中createdAt字段标注了@ServerTimestamp，当这个字段为null时，Kotlin序列化会自动把它转换成FieldValue.serverTimestamp()。但Firestore只允许FieldValue直接用于文档的顶级字段的set()/update()操作，不能把它作为数组中的元素值传递给arrayUnion，这就触发了报错。

根据你的需求，有两种可行的解决方式：

方案1：临时处理Product对象，避免FieldValue出现在数组元素中 #

在调用arrayUnion之前，创建一个不包含FieldValue的Product副本，手动设置createdAt为具体值或者null（这里要避开@ServerTimestamp的自动转换逻辑）：

// 创建一个临时Product对象，手动设置字段，避免生成FieldValue
val productToAdd = Product(
    id = product.id,
    name = product.name,
    createdAt = Date() // 使用客户端时间，不需要的话也可以设为null
)

// 执行update操作
cartsRef.document(cartId)
    .update("products", FieldValue.arrayUnion(productToAdd))
    .addOnCompleteListener { /* 处理回调逻辑 */ }

如果必须使用服务器时间，这种方式就不适用了——因为Firestore无法单独更新数组中的某个元素的字段，此时建议采用方案2。

方案2：将products从数组改为子集合 #

Firestore的数组操作有诸多限制（无法单独更新元素、元素不能包含特殊类型等），如果你的每个Product需要独立的服务器时间戳，更合理的结构是把products设为cartId文档下的子集合，每个Product作为单独的文档存储：

// 添加Product到cart的products子集合
cartsRef.document(cartId)
    .collection("products")
    .document(product.id ?: UUID.randomUUID().toString())
    .set(product) // 这里可以正常使用@ServerTimestamp，因为是直接设置文档字段
    .addOnCompleteListener { /* 处理回调逻辑 */ }

这种结构的优势：

• 可以正常使用@ServerTimestamp生成服务器时间
• 支持单独更新、删除某个Product文档
• 更容易实现查询、分页等复杂操作

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