在 Apple 平台上处理 Cloud Storage 错误

在您构建应用时，事情有时并不会按预期发展，而是会发生错误。

如有疑问，请检查返回的错误并查看错误消息的内容。

如果您已查看错误消息并且 Cloud Storage Security Rules 允许您执行操作，但仍然无法消除错误，请访问我们的支持页面，并告诉我们如何为您提供帮助。

处理错误消息

很多原因都可能导致错误发生，包括文件不存在、用户没有访问所需文件的权限，或者用户取消文件上传操作。

要正确诊断问题并处理错误，请查看下面的完整列表，了解我们的客户端可能报告的所有错误以及错误发生原因。

名称 原因
FIRStorageErrorCodeUnknown 发生未知错误。
FIRStorageErrorCodeObjectNotFound 指定的引用中没有任何对象。
FIRStorageErrorCodeBucketNotFound 没有为 Cloud Storage 配置存储桶。
FIRStorageErrorCodeProjectNotFound 没有为 Cloud Storage 配置项目。
FIRStorageErrorCodeQuotaExceeded 已超过您的 Cloud Storage 存储桶的配额。如果您使用的是 Spark 定价方案，不妨考虑升级到随用随付 Blaze 定价方案。如果您已采用 Blaze 定价方案，请与 Firebase 支持团队联系。

重要提示：自 2025 年 10 月 1 日起，必须采用 Blaze 定价方案才能使用 Cloud Storage，即使是默认存储桶也是如此。
FIRStorageErrorCodeUnauthenticated 用户未经过身份验证。请执行身份验证，然后重试。
FIRStorageErrorCodeUnauthorized 用户无权执行所请求的操作。请检查您的规则以确保其正确无误。
FIRStorageErrorCodeRetryLimitExceeded 已超出某项操作（上传、下载、删除等）的最长时间限制。请尝试重新上传。
FIRStorageErrorCodeNonMatchingChecksum 客户端上的文件与服务器收到的文件的校验和不匹配。请尝试重新上传。
FIRStorageErrorCodeCanceled 用户已取消操作。
FIRStorageErrorCodeDownloadSizeExceeded 所下载文件的大小超过分配给下载操作的内存容量。可调高内存限值并重新尝试下载。