获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

处理 Web 上的 Cloud Storage 错误

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

有时,当您构建应用程序时,事情不会按计划进行并且会发生错误!

如有疑问,请检查错误处理程序(或 Promises 的catch()函数),并查看错误消息的内容。

如果您已查看错误消息并拥有允许您执行操作的云存储安全规则,但仍在努力解决错误,请访问我们的支持页面并告知我们如何提供帮助。

处理错误信息

发生错误的原因有很多,包括文件不存在、用户无权访问所需文件或用户取消文件上传。

为了正确诊断问题并处理错误,这里是我们的客户将提出的所有错误及其发生方式的完整列表。

代码原因
storage/unknown出现未知错误。
storage/object-not-found所需引用处不存在对象。
storage/bucket-not-found没有为 Cloud Storage 配置存储桶
storage/project-not-found没有为 Cloud Storage 配置项目
storage/quota-exceeded已超出您的 Cloud Storage 存储桶的配额。如果您使用的是免费套餐,请升级到付费套餐。如果您使用的是付费计划,请联系 Firebase 支持人员。
storage/unauthenticated用户未通过身份验证,请进行身份验证并重试。
storage/unauthorized用户无权执行所需的操作,请检查您的安全规则以确保它们正确无误。
storage/retry-limit-exceeded已超过操作(上传、下载、删除等)的最大时间限制。尝试重新上传。
storage/invalid-checksum客户端上的文件与服务器接收到的文件的校验和不匹配。尝试重新上传。
storage/canceled用户取消了操作。
storage/invalid-event-name提供的事件名称无效。必须是 [ `running` , `progress` , `pause` ] 之一
storage/invalid-url提供给refFromURL()的 URL 无效。必须采用以下形式:gs://bucket/object 或 https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN>
storage/invalid-argument传递给put()的参数必须是 `File`、`Blob` 或 `UInt8` 数组。传递给putString()的参数必须是原始字符串、“Base64”或“Base64URL”字符串。
storage/no-default-bucket您的配置的storageBucket属性中没有设置存储桶。
storage/cannot-slice-blob通常在本地文件发生更改(删除、再次保存等)时发生。确认文件没有变化后再次尝试上传。
storage/server-file-wrong-size客户端上的文件与服务器接收到的文件大小不匹配。尝试重新上传。