如何为ActiveStorage在S3中实现类层级文件存储结构？

当然可以实现！ActiveStorage默认的扁平存储结构确实和之前Paperclip的层级习惯不太一样，但我们可以通过修改Blob的key生成逻辑，轻松实现按模型甚至实例ID划分文件夹的存储结构。下面分享两种常用方案：

方案一：全局通用配置（无需修改每个模型） #

这个方案会给所有模型的附件自动添加「模型类复数名+实例ID」的前缀，最终存储路径类似 products/123/xxxxxx.png。

1. 创建ActiveStorage初始化器
   在config/initializers/active_storage.rb中添加以下代码：

# 拦截Attachment创建事件，给关联的Blob添加模型路径前缀
ActiveStorage::Attachment.before_create do |attachment|
  record = attachment.record
  # 生成前缀：模型类名复数化/实例ID/
  prefix = "#{record.class.name.underscore.pluralize}/#{record.id}/"
  
  # 避免重复添加前缀（比如重新保存记录时）
  unless attachment.blob.key.start_with?(prefix)
    attachment.blob.key = prefix + attachment.blob.key
    attachment.blob.save!
  end
end

原理：当Attachment（关联模型和Blob的中间记录）创建时，我们获取对应的模型实例，生成层级前缀并修改Blob的key。S3会根据key中的/自动虚拟出文件夹结构，这样文件就会按「模型名/实例ID/随机字符串/文件名」的层级存储了。

2. 重启Rails服务器
   修改初始化器后需要重启服务器，配置才能生效。

方案二：针对单个模型自定义路径 #

如果你只想给特定模型设置自定义路径（比如只给Product模型配置），可以在模型的附件定义中直接指定key的生成逻辑：

class Product < ApplicationRecord
  # 单附件：主图
  has_one_attached :image do |attachable|
    # 自定义key格式：products/实例ID/随机UUID/文件名
    attachable.key = -> { "products/#{id}/#{SecureRandom.uuid}/#{image.filename}" }
  end

  # 多附件：图库图片
  has_many_attached :gallery_images do |attachable|
    attachable.key = -> { "products/#{id}/gallery/#{SecureRandom.uuid}/#{gallery_images.filename}" }
  end
end

这种方式更灵活，可以针对不同的附件设置不同的子路径，比如把产品主图和图库图片分开存储。

注意事项 #

• 若已有现存文件，修改key后不会自动迁移旧文件路径，需要手动在S3上移动或写脚本批量迁移。
• 确保S3桶的权限配置正确，允许Rails应用读写这些路径下的文件。
• 自定义key时要保证唯一性，SecureRandom.uuid是避免文件名冲突的可靠选择。

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