配置Firebase Storage CORS时遇文件不存在错误求助

开发者阿泽

2026-5-20

解决 gsutil cors 配置时的 "No such file or directory" 错误

嘿，我之前刚上手GCloud SDK时也踩过这个坑，别慌，咱们一步步来排查解决：

这个错误的核心很明确——终端找不到你指定的 cors-json-file.json 文件，咱们从最基础的环节开始检查：

确认文件在当前终端的工作目录里
先在终端输入 ls（Mac/Linux系统）或者 dir（Windows系统），看看输出的文件列表里有没有这个JSON文件。如果没有，要么是你还没创建这个文件，要么是你打开终端的目录和文件所在目录不一致。
要是文件在别的文件夹里，别直接写文件名，得用绝对路径来指定，比如：
```
# Mac/Linux 示例
gsutil cors set /Users/你的用户名/文档/cors-json-file.json gs://你的存储桶名称
# Windows 示例
gsutil cors set C:\Users\你的用户名\文档\cors-json-file.json gs://你的存储桶名称
```
嫌手动输路径麻烦？直接把JSON文件拖到终端窗口里，终端会自动帮你填充正确的绝对路径。
确认JSON文件格式符合要求
虽然当前错误是找不到文件，但提前确保文件格式正确能避免后续踩坑，官方要求的格式示例如下：
```
[
  {
    "origin": ["https://你的应用域名.com"],
    "method": ["GET", "POST", "PUT"],
    "responseHeader": ["Content-Type"],
    "maxAgeSeconds": 3600
  }
]
```
注意不要漏写括号、逗号，也不要有多余的逗号导致JSON语法错误。
顺带检查存储桶名称是否正确
Firebase Storage的存储桶名称一般是 你的项目ID.appspot.com，别写错了，这步和当前错误无关，但配置成功后需要确保这部分正确。