Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

Cloud Storage for Firebase 常见问题解答和问题排查

本页面提供了问题排查帮助，并解答了有关使用 Cloud Storage for Firebase 的常见问题。如果您找不到想要的内容或需要其他帮助，请与 Firebase 支持团队联系。

常规问题排查/常见问题解答

2024 年 9 月宣布的默认存储分区有何变化？

如需详细了解对默认 Cloud Storage 存储桶的更改，请参阅 Cloud Storage 文档。

2024 年 9 月宣布的 Cloud Storage 定价方案要求有何变化？

如需详细了解 Cloud Storage 的定价方案要求变更，请参阅 Cloud Storage 文档。

为什么我发现上传和下载操作次数意外增加？

之前，向 Cloud Storage for Firebase API 发出的下载和上传请求未得到正确统计。我们已采取措施解决此问题，自 2023 年 9 月 15 日起生效。

我们建议您监控用量页面，了解是否有用量增加可能计入您的限额。

如何预测上传和下载操作将支付多少费用？

访问 Firebase 价格页面并使用 Blaze 定价方案计算器。该计算器列出了 Cloud Storage for Firebase 的所有使用类型。

使用滑块输入 Storage 存储桶的预期用量。计算器用于估算您的每月账单费用。

为什么我在控制台中或使用 Cloud Storage for Firebase API 时会收到服务账号权限错误（例如错误代码 412）？

以下是出现这些错误的可能原因：

您的项目未启用 Cloud Storage for Firebase API。

您可以在 Google Cloud 控制台中查看该 API 是否已启用。如需了解如何在项目中查找已启用的 API 以及如何启用这些 API，请参阅本Google Cloud指南。
Cloud Storage for Firebase 所需的服务账号存在以下问题之一：
- 服务账号缺少所需的权限。
- 服务账号已被删除。请注意，在 Firebase 控制台中，如果服务账号缺失，可能会导致无法添加所需的 IAM 权限。
对于这两个服务账号问题，请参阅本页面上的相关常见问题解答。

为什么在使用 Cloud Storage for Firebase 的 Firebase 项目中看到新的或多个服务账号？

Firebase 使用服务账号来运行和管理服务，而无需共享用户凭据。创建 Firebase 项目时，您可能会发现项目中已经有一些服务账号。

Cloud Storage for Firebase 所需的服务账号的作用域限定为您的项目，且该服务账号名为：service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com。

如果您在 2022 年 9 月 19 日之前使用 Cloud Storage for Firebase，则可能会在之前关联的 Cloud Storage 存储分区中看到另一个名为 firebase-storage@system.gserviceaccount.com 的服务账号。自 2022 年 9 月 19 日起，此旧版服务账号已不再受支持。

您可以在 Firebase 控制台的服务账号标签页中查看您的项目的所有服务账号。

添加所需的服务账号（如果缺少）

如果您删除了必需的服务账号，或者项目中不存在该服务账号，则可以执行以下任一操作来添加该服务账号。

在 Firebase 控制台中，缺少服务账号可能会导致无法添加所需的 IAM 权限。

（推荐）自动：使用 AddFirebase REST 端点将您的存储分区重新导入 Firebase。您只需要调用此端点一次，不需要为每个关联的存储分区分别调用该端点。
手动：按照创建和管理服务账号中的步骤操作。

参照该指南，添加具有 IAM 角色 Cloud Storage for Firebase Service Agent 且名为 service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com 的服务账号。

移除必需的服务账号

我们强烈建议您不要移除服务账号，因为这可能会导致您的应用无法访问 Cloud Storage 存储分区。如需从项目中移除服务账号，请按照停用服务账号中的说明操作。