Flutter调用Cloud Firestore报permission-denied权限错误

问题场景 #

在Flutter应用中接入Firebase Cloud Firestore读取数据并渲染页面，开发阶段运行时突然出现权限类报错，修改安全规则为全量允许读写后问题仍未解决，无法正常读取videos集合及用户路径下的数据。

现有业务实现代码 #

StreamBuilder<QuerySnapshot>(
  stream: FirebaseFirestore.instance.collection('videos').snapshots(),
  builder: (BuildContext context, AsyncSnapshot<QuerySnapshot> snapshot) {
    if (snapshot.hasError) {
      return Text('Something went wrong!');
    }
    if (snapshot.connectionState == ConnectionState.waiting) {
      return Center(child: CircularProgressIndicator());
    }
    return ListView(
      shrinkWrap: true,
      physics: ClampingScrollPhysics(),
      children: snapshot.data!.docs.map((DocumentSnapshot document) {
        Map<String, dynamic> data = document.data()! as Map<String, dynamic>;
        return GestureDetector(
          onTap: () {},
          child: HomeDisplayScreen(
            videoLink: data['videoLink'],
            imageUrl: data['imageUrl'],
            title: data['title'],
            likes: data['likes'],
          ),
        );
      }).toList(),
    );
  }
)

运行抛出的错误日志 #

W/Firestore( 8345): (24.1.2) [Firestore]: Listen for Query(target=Query(videos order by __name__);limitType=LIMIT_TO_FIRST) failed: Status{code=PERMISSION_DENIED, description=Missing or insufficient permissions., cause=null}
W/Firestore( 8345): (24.1.2) [Firestore]: Listen for Query(target=Query(users/*****@gmail.com order by __name__);limitType=LIMIT_TO_FIRST) failed: Status{code=PERMISSION_DENIED, description=Missing or insufficient permissions., cause=null}
I/flutter ( 8345): [cloud_firestore/permission-denied] The caller does not have permission to execute the specified operation.

已尝试的修复操作 #

已将Cloud Firestore安全规则修改为允许所有用户读写的配置，规则代码如下：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write : if true;
    }
  }
}

排查修复步骤 #

• 确认规则发布状态：修改安全规则后必须点击控制台规则编辑页右上角的发布按钮才会生效，仅保存草稿不会同步到线上服务。规则发布后存在最长1-2分钟的生效延迟，等待后清除应用后台重试运行即可。
• 校验项目配置一致性：确认Flutter工程内的google-services.json（Android端）、GoogleService-Info.plist（iOS端）和当前操作的Firebase控制台项目完全匹配。如果本地配置文件对应其他开启了严格权限规则的项目，修改当前项目规则不会生效。
• 清除旧凭据干扰：开发阶段频繁切换规则、测试账号时，本地可能缓存了过期的认证凭据或权限校验结果，可直接卸载应用重装，排除本地存储的异常状态影响。
• 临时关闭本地缓存验证：Firestore默认开启本地持久化缓存，旧的缓存状态可能干扰权限校验，可临时关闭持久化做验证，初始化时添加如下配置：

  FirebaseFirestore.instance.settings = const Settings(
    persistenceEnabled: false,
  );
  

  验证读取正常后可按需重新开启持久化。
• 用规则游乐场校验：在Firebase控制台的规则游乐场模块，选择读取操作、路径填/videos，模拟未认证用户发起请求，直接查看规则校验结果。如果游乐场校验通过但客户端仍报错，可确定为客户端配置或连接问题；如果游乐场校验不通过，说明规则未正确发布。

内容的提问来源于stack exchange，提问作者S I D D H A R D H A