Firebase Storage文件上传附加安全参数校验规则不生效如何解决？

问题核心原因 #

你的配置存在三处典型错误，直接导致规则校验不通过：

1. 自定义元数据的取值路径错误，Firebase Storage规则中自定义元数据需要通过customMetadata字段嵌套获取
2. 读/写规则未拆分，读请求触发时request.resource对象本身就是null，将写请求专属的校验逻辑同时应用到读请求会直接触发校验失败
3. 向存储路径拼接查询参数的方案完全错误，child()方法传入的内容会被直接识别为文件路径的一部分，不会被解析为参数，Storage规则也不支持读取路径后的查询参数

正确实现方案 #

方案1：通过自定义元数据校验（仅适用于写请求校验） #

你原本的上传代码无需修改，只需要调整安全规则即可：

// 上传代码保持不变
const metadata = {
  customMetadata: {
    test: "check"
  }
}
storageRef.child('docs/docName').put(file, metadata);

对应安全规则需要拆分读、写权限，并且指定customMetadata层级：

match /docs/{doc} {
  // 读请求不要使用request.resource校验，读操作没有该对象，按你实际的读权限需求配置即可
  allow read: if true;
  // 写请求校验自定义元数据
  allow write: if request.resource.metadata.customMetadata.test == 'check';
}

方案2：通过路径参数校验（适用于读+写请求校验） #

如果你需要同时对读请求也做参数校验，可以将校验值放到存储路径中：

// 上传代码调整为将校验值放到路径层级中
storageRef.child('docs/check/docName').put(file, metadata);

对应安全规则直接提取路径参数校验即可：

match /docs/{test}/{doc} {
  // 读写都可以直接校验路径提取的test参数
  allow read, write: if test == 'check';
}

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