Swift中重命名Firebase Firestore字典键名且保留原值的方法

Firestore 没有提供单步重命名字段（字典键）的原生API，不需要全量读取、覆写整个父字典，最高效的实现方式是原子操作组合：读取目标键值 → 写入同值到新键路径 → 删除旧键，全程只会操作必要字段，不会触碰其他无关数据。

实现逻辑说明 #

• 支持通过点路径直接定位嵌套字段，不需要拉取整个Animals父字典，也不需要拉取文档下其他无关内容
• 读取阶段仅获取需要迁移的Animals.Cats字段值，网络开销可以忽略
• 写入阶段用批量写（Batch Write）保证原子性：新键写入、旧键删除两个动作要么全部成功，要么全部失败，不会出现数据不一致
• 用updateData而非setData执行更新，不会覆盖Animals下其他已有的子字段

可直接复用的代码实现 #

补全你现有框架的逻辑如下，注意把文档路径替换为你项目中实际的存储路径：

let db = Firestore.firestore()

guard let userID = Auth.auth().currentUser?.uid else {
    print("The user is not signed into an account.")
    return
}

// 替换为你项目中实际存储该数据的文档引用
let targetDocRef = db.collection("你的用户集合名").document(userID)

// 仅读取目标嵌套字段，无冗余数据拉取
targetDocRef.getDocument { snapshot, error in
    guard error == nil, let docData = snapshot?.data() else {
        print("字段读取失败: \(error?.localizedDescription ?? "未知错误")")
        return
    }
    
    // 提取Cats键下存储的原有数组值
    guard let animalsData = docData["Animals"] as? [String: Any],
          let catNameList = animalsData["Cats"] as? [String] else {
        print("未找到待迁移的Cats字段")
        return
    }
    
    // 原子批量操作：写入新键 + 删除旧键
    let writeBatch = db.batch()
    writeBatch.updateData([
        "Animals.Dogs": catNameList,
        "Animals.Cats": FieldValue.delete()
    ], forDocument: targetDocRef)
    
    writeBatch.commit { commitError in
        if let commitError = commitError {
            print("字段重命名失败: \(commitError.localizedDescription)")
            return
        }
        print("重命名完成，Jimmy/Lola/Timmy等所有原有数据已完整迁移到Dogs键下")
    }
}

额外优化提示 #

• 如果你业务层本地已经持有Animals.Cats的最新值，可以跳过上面的读取步骤，直接执行批量写入操作，实现零额外读开销完成重命名
• 禁止直接覆写整个Animals字典，否则如果在你读取到写入的间隙有其他端修改了Animals下的其他字段（比如新增了Rabbits子键），会被你的全量写入直接覆盖丢失

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