处理 Unity 版 Cloud Storage 错误

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

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

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

处理错误消息

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

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

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

重要提示:自 2025 年 10 月 1 日起,Blaze 定价方案将是使用 Cloud Storage 的必要条件,即使是默认存储桶也是如此。
ErrorNotAuthenticated 用户未经过身份验证。请执行身份验证,然后重试。
ErrorNotAuthorized 用户无权执行所请求的操作。请检查您的规则以确保其正确无误。
ErrorRetryLimitExceeded 已超出某项操作(上传、下载、删除等)的最长时间限制。请尝试重新上传。
ErrorInvalidChecksum 客户端上的文件与服务器收到的文件的校验和不匹配。请尝试重新上传。
ErrorCanceled 用户已取消操作。