Firebase Firestore Android限制文档字段数与竞态条件规避问题

1. 多用户并发操作的新建文档竞态问题解决 #

你只需要把完整的写入+阈值判断+新建文档逻辑封装在Firestore原生的**事务（Transaction）**中即可彻底解决竞态问题，Firestore事务由服务端保证原子性，并发冲突时会自动重试，不会出现多请求同时创建新文档的情况。
具体实现逻辑参考：

• 额外新增一个独立的元数据文档（比如路径为metadata/current_slice），专门存储当前正在写入的活跃切片文档ID，不用每次遍历整个集合找最新文档，性能更高。
• 所有写入操作都必须走事务逻辑，事务内先读元数据文档拿到当前活跃切片ID，再读切片文档统计现有字段数：
  • 字段数未达阈值：直接在当前切片写入新字段
  • 字段数已达阈值：事务内同时完成「创建新切片文档写入当前数据、更新元数据文档的活跃切片ID」两个操作

安卓端的实现代码示例：

// 阈值可自定义，这里示例设为10
const val FIELD_COUNT_THRESHOLD = 10

val firestore = FirebaseFirestore.getInstance()
firestore.runTransaction { transaction ->
    // 读取活跃切片元数据
    val metaDocRef = firestore.document("metadata/current_slice")
    val metaDoc = transaction.get(metaDocRef)
    val activeSliceId = metaDoc.getString("active_slice_id") ?: "slice_001"

    // 读取当前活跃切片内容
    val currentSliceRef = firestore.document("data_set/$activeSliceId")
    val currentSlice = transaction.get(currentSliceRef)
    val existingFieldCount = currentSlice.data?.size ?: 0

    if (existingFieldCount < FIELD_COUNT_THRESHOLD) {
        // 未达阈值直接写入新字段
        transaction.update(currentSliceRef, newFieldKey, newFieldValue)
    } else {
        // 达到阈值，生成新切片ID
        val sliceSerialNum = activeSliceId.split("_")[1].toInt()
        val newSliceId = "slice_${sliceSerialNum + 1}"
        val newSliceRef = firestore.document("data_set/$newSliceId")
        // 原子操作：写入新切片 + 更新元数据的活跃切片ID
        transaction.set(newSliceRef, mapOf(newFieldKey to newFieldValue))
        transaction.update(metaDocRef, "active_slice_id", newSliceId)
    }
    null
}.addOnSuccessListener {
    // 写入完成处理
}.addOnFailureListener {
    // 异常处理
}

2. 多文档分片存储方案的可行性 #

这个方案完全具备可行性，是Firestore开发中规避单文档大小/字段数限制的常用方案，不过需要注意适配你的业务场景：

适用场景 #

• 写入的是同类型的流水类数据，比如用户操作记录、埋点上报数据、消息记录等，不需要频繁做跨切片的复杂联合查询
• 单文档字段数或大小增长很快，容易触达Firestore单文档1MB的硬限制

注意事项 #

• 阈值不要设置过小，建议结合单个字段的平均大小计算，预留足够的缓冲空间，避免生成过多小文档提升读写成本。比如单字段平均大小为1KB的话，阈值设置为500~800都属于合理范围，不用卡着1MB上限设置
• 如果后续需要对所有切片的字段做统一查询，建议把常用查询的维度字段冗余到元数据或者每个切片的根字段中，额外配置复合索引，避免每次查询都拉取全量切片文档
• 已经归档的非活跃切片建议加标记禁止修改，降低权限控制和数据一致性的风险

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