如何在Kotlin中更新Firestore数据库的文档ID？

能否直接更新文档ID？ #

Firestore不支持直接更新文档ID，文档ID是文档的核心唯一标识，属于文档路径的组成部分，无法通过update()方法修改。你接触到的update()方法仅用于修改文档内部的字段值，且必须作用于具体的文档引用（即通过.document("DC")指定后的对象）；集合引用本身没有update()方法，因为集合是多个文档的容器，无法直接对整个集合执行统一更新操作。

实现文档ID变更的可行方案 #

要达到类似“更新文档ID”的效果，只能通过复制旧文档数据到新ID文档，再删除旧文档的方式完成，具体步骤如下：

1. 读取旧文档数据 #

先获取旧ID文档的完整字段数据：

val oldDocRef = db.collection("cities").document("DC")
oldDocRef.get().addOnSuccessListener { documentSnapshot ->
    if (documentSnapshot.exists()) {
        val docData = documentSnapshot.data
        // 读取成功后执行写入新文档操作
    }
}.addOnFailureListener { e ->
    Log.w(TAG, "读取旧文档失败", e)
}

2. 写入新ID文档并删除旧文档 #

创建新ID的文档引用，将旧文档数据写入，成功后删除旧文档：

val newDocRef = db.collection("cities").document("NEW_DC")
newDocRef.set(docData!!)
    .addOnSuccessListener {
        oldDocRef.delete()
            .addOnSuccessListener { Log.d(TAG, "文档ID更新完成，旧文档已删除") }
            .addOnFailureListener { e -> Log.w(TAG, "删除旧文档失败", e) }
    }
    .addOnFailureListener { e -> Log.w(TAG, "写入新文档失败", e) }

关键注意事项 #

• 上述操作分为两步，建议用Firestore事务包裹，避免中间异常导致数据不一致：

db.runTransaction { transaction ->
    val oldDoc = transaction.get(oldDocRef)
    transaction.set(newDocRef, oldDoc.data!!)
    transaction.delete(oldDocRef)
}.addOnSuccessListener {
    Log.d(TAG, "文档ID更新事务执行成功")
}.addOnFailureListener { e ->
    Log.w(TAG, "事务执行失败", e)
}

• 如果旧文档包含子集合，需要额外迁移子集合数据——子集合关联的是旧文档的路径，不会随文档ID变更自动转移。

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