Firebase规则中如何在Firestore写入时校验对应Cloud Storage文件是否存在

方案1：Firestore安全规则校验（客户端直写场景推荐） #

你之前调用exists()未生效，大概率是存储桶路径格式错误或文件路径不匹配，按以下规则调整即可：

规则示例 #

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // 替换为实际业务集合路径
    match /your_collection/{documentId} {
      allow write: if 
        // 校验请求参数包含文件名字段
        request.resource.data.keys().hasAny(['storage_file_name']) &&
        // 核心校验逻辑：桶名不需要加gs://前缀，文件名必须是Storage内的完整存储路径
        exists(/b/替换为你的存储桶名称/o/$(request.resource.data.storage_file_name));
    }
  }
}

常见问题排查 #

• 存储桶名不能带gs://、https://等前缀，仅填写纯名称即可
• 写入Firestore的文件名必须和Storage内的路径完全一致，例如文件存放在upload/2024/test.png，则字段值不能仅填test.png
• 若你修改过Storage默认安全规则，需确保规则引擎有读取文件元数据的权限，可在Storage规则中添加如下配置：

service firebase.storage {
  match /b/{bucket}/o {
    match /{allPaths=**} {
      allow read: if true; // 可根据业务调整权限阈值，只要支持元数据读取即可
    }
  }
}

方案2：Admin SDK校验（后端/云函数写入场景适用） #

如果Firestore写入逻辑由服务端/云函数触发，直接调用Google Cloud Storage SDK的exists()方法校验即可：

// Node.js 示例
const { Storage } = require('@google-cloud/storage');
const storage = new Storage();
// 初始化存储桶实例
const businessBucket = storage.bucket('替换为你的存储桶名称');

// 写入Firestore前调用该校验方法
async function validateFileExisted(fileFullPath) {
  const [isExisted] = await businessBucket.file(fileFullPath).exists();
  return isExisted;
}

注意事项 #

• 服务账号需要拥有storage.objects.get权限，默认的云函数服务账号已自带该权限
• 同安全规则要求，必须传入文件在Storage中的完整路径

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