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

处理错误消息

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

为了正确诊断问题并处理错误，请查看下面的完整列表，了解我们的客户端可能报告的所有 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	用户已取消操作。