使用react-native-fs从Firebase Storage下载文件时遭遇403权限错误排查

以下是针对你遇到的403错误的可能原因及解决建议：

1. 下载URL的Token无效或过期 #

你使用的下载URL包含token参数，这个Token通常是临时授权凭证，可能存在过期、权限范围不匹配的情况。

• 解决：既然你的Storage规则已允许公开读取，可直接使用不带token的基础下载URL（格式为https://firebasestorage.googleapis.com/v0/b/{bucket}/o/{filePath}?alt=media），无需携带Token即可访问。
• 验证：直接在浏览器中打开示例URL，若也返回403，说明Token确实无效，重新生成有效Token或改用无Token的公开链接。

2. 请求头设置不当 #

你的代码中添加了Accept和Content-Type请求头，但Firebase Storage的下载接口对这些头可能有严格限制——Content-Type在GET请求中属于冗余设置，可能触发服务器的权限拦截逻辑。

• 解决：移除请求头配置，简化options中的headers字段（或直接删除该属性），重新发起请求：

  const options: DownloadFileOptions = {
    fromUrl: url,
    toFile: savedToPath,
    connectionTimeout: 10 * 60 * 1000,
    readTimeout: 10 * 60 * 1000,
    progressDivider: 10,
    progressInterval: 100,
    progress: res => this.showProgress(title, res),
  };
  

3. Firebase Storage规则未正确生效 #

规则修改后可能存在延迟生效的情况，或者规则匹配逻辑与实际文件路径不匹配。

• 解决：
  • 等待5-10分钟，确保规则已同步到服务器；
  • 使用Firebase控制台的规则模拟器，模拟对目标文件的读取请求，验证规则是否允许访问；
  • 确认文件路径与规则中的{allPaths=**}匹配（你的文件在media/目录下，规则已覆盖所有子路径，此点大概率无问题）。

4. 下载工具的请求逻辑问题 #

你使用的downloadFile工具（推测为React Native相关库）可能存在HTTPS请求处理异常，比如未正确处理证书、代理设置干扰等。

• 解决：
  • 先用浏览器或curl命令直接访问下载URL，确认是否能正常下载：

    curl -I "https://firebasestorage.googleapis.com/v0/b/pangaea-2f1a0.appspot.com/o/media%2F1707074809001_here_gif?alt=media"
    

  • 若浏览器能正常下载但代码不行，排查工具库的版本或配置问题，尝试更换下载方式（比如使用fetch配合文件写入）。

5. Google Cloud Storage IAM权限限制 #

除了Firebase Storage规则，底层的Google Cloud Storage存储桶可能存在IAM权限限制，禁止公共读取。

• 解决：
  • 登录Google Cloud控制台，找到对应的存储桶；
  • 检查IAM权限，确保添加了allUsers角色并授予Storage Object Viewer权限（仅在需要完全公开读取时使用）。

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