You need to enable JavaScript to run this app. Firebase Cloud Firestore 嵌套集合细粒度权限安全规则配置
优惠活动
大模型
产品
解决方案
定价
更多

Firebase Cloud Firestore 嵌套集合细粒度权限安全规则配置

适配数据库结构和权限要求的Firestore安全规则实现

核心规则设计逻辑

  • 放弃原有的全局通配符兜底逻辑,严格按照实际文档层级匹配路径,避免无边界权限开放带来的安全风险
  • 针对users集合的用户文档做精细化读权限拆分:未授权用户仅能读取username公开字段,不暴露文档内其他敏感信息;已授权用户可正常读取所有文档内容
  • 所有嵌套子集合(wishlists、wünsche)的读权限,仅对完成身份认证的用户开放
  • 写入权限做分层校验:普通文档、普通字段仅允许文档归属用户修改;单独放行wünsche文档中isReservedFrom字段的跨用户写入权限,匹配预留愿望的业务场景

完整可运行的规则代码

service cloud.firestore {
  match /databases/{database}/documents {

    // 匹配users集合下的单个用户文档(路径:users/{用户UID})
    match /users/{userId} {
      // 读权限规则:
      // 1. 已授权用户:可完整读取用户文档所有字段
      // 2. 未授权用户(含匿名未登录):仅允许读取文档内的username公开字段,无法获取其他敏感字段
      allow read: if request.auth != null 
        || (request.auth == null && request.query.selectFields.hasOnly(["username"]));
      
      // 写权限规则:用户仅能修改自己归属的用户文档,其他用户无权修改
      allow write: if request.auth != null && request.auth.uid == userId;


      // 匹配用户文档下的wishlists子集合(路径:users/{用户UID}/wishlists/{wishlistID})
      match /wishlists/{wishlistId} {
        // 读权限:所有已授权用户均可读取
        allow read: if request.auth != null;

        // 写权限:仅wishlist归属的用户可修改自身的wishlist内容
        allow write: if request.auth != null && request.auth.uid == userId;


        // 匹配wishlist下的wünsche子集合(路径:users/{用户UID}/wishlists/{wishlistID}/wünsche/{wunschID})
        match /wünsche/{wunschId} {
          // 读权限:所有已授权用户均可读取
          allow read: if request.auth != null;

          // 写权限:
          // 1. 普通字段修改:仅wünsche文档归属的用户可操作
          // 2. isReservedFrom字段修改:所有已授权用户均可操作
          allow write: if request.auth != null && (
            request.auth.uid == userId 
            || request.resource.data.diff(resource.data).affectedKeys().hasOnly(["isReservedFrom"])
          );
        }
      }
    }
  }
}

关键规则说明

  • 未授权用户的公开读限制:通过request.query.selectFields判断客户端请求读取的字段范围,未登录用户如果尝试获取完整用户文档、或读取除username外的其他字段,会被规则拦截,避免敏感信息泄露
  • wünsche的跨用户写入逻辑:通过resource.data.diff()方法判断本次写入实际修改的字段范围,只要修改范围仅包含isReservedFrom字段,无论文档归属哪个用户,已登录用户都可以完成写入,不会影响文档内其他字段的修改权限
  • 规则匹配优先级:Firestore会优先匹配路径最具体的规则,不会被外层通配符规则覆盖,所有权限边界都会严格按照上述层级校验

内容的提问来源于stack exchange,提问作者Chris

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 23:36:10