在 Apple 平台上处理 Cloud Storage 错误

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

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

注意：默认情况下，需要经过 Firebase Authentication 身份验证才能对 Cloud Storage for Firebase 存储桶中的数据或文件执行操作。您可以更改 Cloud Storage 的 Firebase Security Rules，以允许在特定情况下进行未经身份验证的访问。不过，在大多数情况下，我们强烈建议限制访问权限并设置强大的安全规则（尤其是对于正式版应用）。请注意，如果您使用 Google App Engine 且默认 Cloud Storage 存储桶的名称格式为 *.appspot.com，则可能需要考虑安全规则对 App Engine 文件的访问有何影响。

如果您已查看错误消息并且 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	所下载文件的大小超过分配给下载操作的内存容量。可调高内存限值并重新尝试下载。