Kotlin中Firestore Upsert优化咨询（无需失败回调）

核心优化：单次请求实现Upsert #

你当前先尝试update再捕获异常触发set的两次请求方案可以简化——Firestore的set()方法结合SetOptions.merge()，配合FieldValue.arrayUnion()，能在单次请求中完成「文档不存在则创建并初始化数组，存在则追加元素」的逻辑，完全避免二次请求。

添加高亮的优化代码 #

usersCollection
    .document(userId)
    .collection("userDocuments")
    .document(docId)
    .set(
        mapOf("highlights" to FieldValue.arrayUnion(text)),
        SetOptions.merge()
    )

• 当{docId}文档不存在时：Firestore会自动创建该文档，并将highlights字段初始化为包含目标文本的数组
• 当{docId}文档已存在时：自动将文本追加到现有数组中（arrayUnion会自动跳过重复元素，无需额外去重逻辑）

移除高亮的处理逻辑 #

如果是移除高亮操作，用FieldValue.arrayRemove()配合同样的set+merge逻辑即可，且完全符合你「仅在有实际操作时创建文档」的需求：

usersCollection
    .document(userId)
    .collection("userDocuments")
    .document(docId)
    .set(
        mapOf("highlights" to FieldValue.arrayRemove(text)),
        SetOptions.merge()
    )

• 若目标文档不存在：set+merge结合arrayRemove不会创建新文档（无有效字段需要写入）
• 若目标文档存在：会从highlights数组中移除指定文本

数据结构进阶优化建议 #

如果你的高亮内容需要存储更多元数据（比如高亮位置、创建时间、用户备注等），或未来可能产生大量高亮条目，建议将highlights数组改为子集合：

• 每个高亮作为userDocuments/{docId}/highlights/{highlightId}下的独立文档
• 规避Firestore单文档1MB的大小限制，同时支持更灵活的查询（比如按创建时间筛选高亮）
• 操作逻辑更直观，无需处理数组相关的限制

优化后的结构示例 #

users/{userId}
  └── userDocuments/{docId}
      └── highlights/{highlightId}
          ├── text: "高亮文本内容"
          ├── position: {start: 10, end: 20}
          ├── createdAt: Timestamp.now()

对应操作代码 #

添加高亮：

usersCollection
    .document(userId)
    .collection("userDocuments")
    .document(docId)
    .collection("highlights")
    .document(UUID.randomUUID().toString()) // 用唯一ID作为高亮文档标识
    .set(mapOf(
        "text" to text,
        "createdAt" to Timestamp.now()
    ))

移除高亮：直接删除对应highlightId的文档即可。

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