如何修改Firebase Storage的默认bucket及调整bucket所在位置

1. 修改默认bucket #

• 打开Firebase控制台，进入对应项目的Storage模块
• 确认你要设置为默认的目标bucket已经在当前项目下存在
• 编辑项目根目录的firebase.json配置文件，修改storage配置段的defaultBucket参数为目标bucket的完整名称，示例如下：

{
  "storage": {
    "defaultBucket": "目标bucket完整名称"
  }
}

• 如果你在客户端/服务端代码中硬编码了Firebase初始化参数，同步修改初始化配置中的storageBucket字段值
• 重新部署项目配置和业务代码后生效

注意：修改默认bucket不会自动迁移原有默认bucket内的文件，需手动完成文件迁移后再调整业务侧的文件读写路径

2. 调整现有bucket的所在位置 #

Firebase Storage的bucket创建后无法直接修改地理位置，必须通过新建bucket+数据迁移的方式完成位置调整，操作步骤如下：

• 进入Firebase控制台Storage页面，点击「添加bucket」按钮，按照流程选择你需要的目标地理位置、存储类，完成新bucket创建
• 给新bucket配置和原有bucket完全相同的安全规则、CORS配置，避免迁移后出现权限错误、跨域问题
• 迁移旧bucket内的文件：
  • 文件量较少时，可直接在控制台下载旧bucket的文件，手动上传到新bucket
  • 文件量较大时，使用Google Cloud SDK的gsutil命令行工具批量迁移，命令示例：
    gsutil cp -r gs://旧bucket名称/* gs://新bucket名称/
• 迁移完成后核对文件完整性、访问权限是否正常，再逐步将业务侧的bucket路径切换为新bucket
• 确认所有业务流量都已经切换到新bucket后，再删除旧bucket避免产生额外存储费用

内容的提问来源于stack exchange，提问作者dylan.kwon