CarrierWave上传至Google Cloud存储失败：启用统一存储桶级权限后报错

问题原因 #

切换到uniform bucket-level access后，Google Storage禁止对象级的遗留ACL操作，但你当前使用的CarrierWave 1.3.2默认会尝试设置对象ACL，导致触发Cannot insert legacy ACL for an object when uniform bucket-level access is enabled错误。

具体解决方案 #

• 禁用CarrierWave的对象ACL设置
  打开CarrierWave初始化配置文件（通常是config/initializers/carrierwave.rb），添加或修改配置，取消默认的ACL设置：

  CarrierWave.configure do |config|
    # 其他配置...
    config.google_storage_acl = nil
  end
  

  这样适配器就不会再向Google Storage发送ACL相关的请求，适配统一桶级权限模式。

• 配置正确的桶级权限
  给CarrierWave使用的Google Cloud服务账号分配合适的桶级角色，确保它有上传对象的权限：

  • 进入Google Cloud控制台的目标存储桶页面
  • 切换到「权限」标签页
  • 添加服务账号的邮箱地址，分配Storage Object Creator（仅上传权限）或Storage Admin（全权限，按需选择最小权限）角色

• 升级CarrierWave版本（推荐）
  你当前使用的1.3.2版本发布时间较早，升级到最新稳定版（如2.x系列）可以获得更完善的Google Storage统一权限支持，减少兼容性问题。执行命令升级：

  bundle update carrierwave
  

  升级后建议重新测试上传流程，确保功能正常。

内容的提问来源于stack exchange，提问作者sagar verma