Flutter开发中如何修改Firestore的usernames集合内的文档名称

开发者阿泽

2026-9-24

Firestore 不支持直接修改已存在的文档ID，你需要通过「复制旧文档数据→写入新ID文档→删除旧文档」的流程实现修改usernames集合的文档名称需求。

你可以参考如下调整后的代码实现：

Future<void> updateUsername(String oldUsername, String newUsername, String uid) async {
  final usernamesRef = FirebaseFirestore.instance.collection('usernames');
  
  // 开启事务保证操作原子性，避免并发冲突
  return FirebaseFirestore.instance.runTransaction((transaction) async {
    // 校验新用户名是否已被占用
    final newDoc = await transaction.get(usernamesRef.doc(newUsername));
    if (newDoc.exists) {
      throw Exception("该用户名已被使用，请更换");
    }

    // 读取旧用户名对应的文档数据
    final oldDoc = await transaction.get(usernamesRef.doc(oldUsername));
    if (!oldDoc.exists) {
      throw Exception("原用户名记录不存在，无法修改");
    }
    // 校验操作权限，避免越权修改他人用户名
    if (oldDoc.get('uid') != uid) {
      throw Exception("无权限修改该用户名");
    }

    // 写入新用户名文档
    transaction.set(usernamesRef.doc(newUsername), {
      'uid': uid,
      'timeCreated': oldDoc.get('timeCreated'), // 保留原有创建时间，可按需替换为当前时间
      'timeUpdated': DateTime.now(), // 可选：新增修改时间标记
    });

    // 删除旧用户名文档
    transaction.delete(usernamesRef.doc(oldUsername));
  }).then((_) => print("用户名修改成功"))
    .catchError((error) => print("用户名修改失败: $error"));
}