Firestore文档初始创建时Map结构生成异常问题求助

问题核心 #

首次创建文档时，使用comparisons.{code}这种点分隔路径执行更新操作，Firestore不会自动将这些字段合并为一个comparisons Map，而是生成大量形如comparisons.12345的独立顶级字段。手动预创建含空Map的文档过于繁琐，希望避免检查文档存在性的额外开销。

解决方案 #

不要使用点路径构造字段名，而是直接构造嵌套Map结构，结合set方法的merge: true参数。这样无论文档是否存在，都能正确生成或更新comparisons Map字段，无需提前检查文档状态。

修正后的代码示例 #

val code = comp.getCode()
val data = mapOf(
    "codes" to FieldValue.arrayUnion(code),
    "comparisons" to mapOf(code to FieldValue.increment(1))
)

db.collection("codes").document("info").set(data, SetOptions.merge())

原理说明 #

• 当文档不存在时，set(merge = true)会直接创建文档，并将comparisons识别为Map类型字段插入；
• 当文档已存在时，会合并comparisons内部的键值对，对指定的code执行增量操作，不会覆盖该Map中已有的其他条目；
• 相比点路径的方式，嵌套Map结构能明确告知Firestore字段的层级关系，避免生成扁平化的独立字段。

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