处理 C++ 版 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 允许您执行操作，但仍然无法消除错误，请访问我们的支持页面，并告诉我们如何为您提供帮助。

处理错误消息

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

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

名称	原因
kErrorNone	不存在错误。
kErrorUnknown	发生未知错误。
kErrorObjectNotFound	指定的引用中没有任何对象。
kErrorBucketNotFound	没有为 Cloud Storage 配置存储桶。
kErrorProjectNotFound	没有为 Cloud Storage 配置项目。
kErrorQuotaExceeded	已超过您的 Cloud Storage 存储桶的配额。如果您使用的是 Spark 定价方案，不妨考虑升级到随用随付 Blaze 定价方案。如果您已采用 Blaze 定价方案，请与 Firebase 支持团队联系。 重要提示：自 2025 年 10 月 1 日起，必须采用 Blaze 定价方案才能使用 Cloud Storage，即使是默认存储桶也是如此。
kErrorUnauthenticated	用户未经过身份验证。请执行身份验证，然后重试。
kErrorUnauthorized	用户无权执行所请求的操作。请检查您的规则以确保其正确无误。
kErrorRetryLimitExceeded	已超出某项操作（上传、下载、删除等）的最长时间限制。请尝试重新上传。
kErrorNonMatchingChecksum	客户端上的文件与服务器收到的文件的校验和不匹配。请尝试重新上传。
kErrorCanceled	用户已取消操作。
kErrorDownloadSizeExceeded	所下载文件的大小超过分配给下载操作的内存容量。可调高内存限值并重新尝试下载。