Shrine upload_options设置checksum_algorithm参数报错求助

核心原因 #

报错本质是当前使用的aws-sdk-s3版本不支持checksum_algorithm参数，或是Shrine传递参数的方式不符合SDK要求。S3的ChecksumAlgorithm属于较新特性，旧版Ruby SDK尚未适配该参数。

解决方案步骤 #

1. 升级aws-sdk-s3版本 #

先通过bundle show aws-sdk-s3查看当前版本，若版本低于1.100.0（该版本开始正式支持checksum_algorithm），需执行升级：
在Gemfile中更新依赖：

gem 'aws-sdk-s3', '>= 1.100.0'

然后运行bundle update aws-sdk-s3完成升级。

2. 调整Shrine参数传递方式 #

若升级SDK后仍报错，可尝试以下两种参数配置方式：

方式一：动态设置上传选项

在你的Shrine上传器中，改用动态逻辑传递参数：

class MyUploader < Shrine
  plugin :upload_options, store: ->(io, context) do
    { checksum_algorithm: 'SHA256' }
  end
end

方式二：直接配置S3客户端默认参数

初始化Shrine存储时，给S3客户端添加默认参数：

Shrine.storages = {
  store: Shrine::Storage::S3.new(
    bucket: ENV['S3_BUCKET'],
    region: ENV['S3_REGION'],
    access_key_id: ENV['S3_ACCESS_KEY'],
    secret_access_key: ENV['S3_SECRET_KEY'],
    upload_options: { checksum_algorithm: 'SHA256' }
    # 也可直接给客户端设默认值
    # client: Aws::S3::Client.new(
    #   region: ENV['S3_REGION'],
    #   access_key_id: ENV['S3_ACCESS_KEY'],
    #   secret_access_key: ENV['S3_SECRET_KEY'],
    #   defaults: { checksum_algorithm: 'SHA256' }
    # )
  )
}

3. 排查参数传递问题 #

若仍有异常，可开启SDK调试日志，确认请求参数是否正确：

Aws.config.update(
  logger: Logger.new($stdout),
  log_level: :debug
)

通过日志可直观看到checksum_algorithm是否被正确包含在请求中，定位参数传递环节的问题。

额外注意 #

• 大文件分块上传时，需确保checksum_algorithm参数同步传递到分块初始化请求中，可配合Shrine的multipart插件调整配置。
• S3桶默认支持校验和特性，无需额外配置权限。

内容的提问来源于stack exchange，提问作者Mike Vallano