Flutter Firestore注册时触发权限拒绝错误求助

注册时调用usernameExists方法检查用户名是否已存在，触发以下FirebaseException：

Exception has occurred. FirebaseException ([cloud_firestore/permission-denied] The caller does not have permission to execute the specified operation.)

相关代码 #

SignUpController类的用户名查重方法 #

Future<bool> usernameExists(String username) async {
    QuerySnapshot querySnapshot = await FirebaseFirestore.instance
        .collection('users')
        .where('username', isEqualTo: username)
        .get();
    return querySnapshot.docs.isNotEmpty;
}

原Firestore安全规则 #

rules_version = '2';

service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if request.auth != null;
    }
  }
}

尝试过的规则（未解决问题） #

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{document=**} {
      allow read;
      allow write: if false; // Deny all write operations
    }
  }
}

问题分析与解决方案 #

核心原因 #

注册流程中，用户名查重操作发生在用户完成Firebase认证之前，此时request.auth为null，原规则要求必须认证才能读写，因此触发权限拒绝。你尝试的规则虽然放开了读权限，但规则匹配逻辑未正确覆盖查询场景，存在优先级问题。

正确的安全规则配置 #

针对注册场景，需要允许未认证用户仅能查询users集合的username字段用于查重，同时保留其他操作的安全性：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // 默认规则：仅认证用户可读写所有文档
    match /{document=**} {
      allow read, write: if request.auth != null;
    }

    // 用户名查重专属规则：允许未认证用户查询username字段
    match /users/{userId} {
      allow read: if request.auth == null && request.query.where('username', '==') != null;
      // 写入规则：仅认证用户可操作自己的文档
      allow write: if request.auth != null && request.auth.uid == userId;
    }
  }
}

额外建议 #

如果你的注册流程可以调整顺序，先完成Firebase用户认证（如调用createUserWithEmailAndPassword），再执行用户名查重，那么原规则即可生效，但这种方式可能会出现“已创建认证用户但用户名重复”的情况，需根据业务需求权衡选择。

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