有时,当您构建应用程序时,事情不会按计划进行并且会发生错误!
如有疑问,请检查错误处理程序(或 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 | 客户端上的文件与服务器接收到的文件大小不匹配。尝试重新上传。 |