如何基于现有S3对象创建ActiveStorage::Blob并关联到对应记录

一、计算S3对象对应ActiveStorage要求的校验和 #

ActiveStorage的checksum字段要求为原始文件二进制内容MD5哈希值的Base64编码格式，分片上传到S3的对象ETag不直接等于该值，需要手动计算：

情况1：持有原始本地文件 #

直接本地计算即可，性能最优：

require 'digest/md5'
require 'base64'

md5_digest = Digest::MD5.file("/path/to/your/local/file.zip").digest
checksum = Base64.strict_encode64(md5_digest)

情况2：无原始文件，仅S3端有对象 #

通过AWS S3 SDK流式拉取对象计算，避免大文件占用过高内存，同时可以获取真实的文件字节数：

require 'aws-sdk-s3'
require 'digest/md5'
require 'base64'

# 初始化S3客户端，默认会读取环境变量中的AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_REGION配置
s3_client = Aws::S3::Client.new
md5 = Digest::MD5.new

# 替换为你的S3桶名和对象key
resp = s3_client.get_object(bucket: "your-s3-bucket", key: "<S3对象的key>") do |chunk|
  md5.update(chunk)
end

checksum = Base64.strict_encode64(md5.digest)
# 同时获取真实文件大小，不要使用虚拟值，ActiveStorage多类功能依赖该字段
real_byte_size = resp.content_length

二、创建合法的ActiveStorage::Blob对象 #

创建时补充校验和、真实字节数，同时设置identified: true跳过ActiveStorage的自动内容识别流程，避免重复请求S3：

blob = ActiveStorage::Blob.create!(
  key: "<S3对象的key>",
  filename: "<自定义文件名>",
  content_type: "application/zip",
  service_name: "<你配置的S3服务名称>",
  byte_size: real_byte_size,
  checksum: checksum,
  identified: true
)

三、将Blob关联到对应业务记录 #

假设你的业务模型为Archive，关联的ActiveStorage附件字段为source_file，有两种关联方式：

方式1：直接通过模型关联方法赋值 #

archive = Archive.find(你的记录ID)
archive.source_file.attach(blob)

方式2：批量场景直接创建关联记录 #

ActiveStorage::Attachment.create!(
  name: "source_file", # 业务模型的附件字段名
  record_type: "Archive", # 业务模型的类名
  record_id: 你的记录ID,
  blob: blob
)

注意事项 #

• 关联完成后可通过record.附件字段名.url、record.附件字段名.download验证可用性
• 如果S3桶开启了版本控制，需确保Blob对应的key匹配你要关联的对象版本

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