如何自定义Rails 5.2 ActiveStorage在Amazon S3的附件路径并归类到子目录？

这个需求太常见了——之前用Paperclip的时候目录分类配置得顺顺当当，换成ActiveStorage反而得绕个小弯子。我来给你两种靠谱的方案，按需选就行：

方案一：单个模型精准配置（最推荐） #

如果只是某几个模型的特定附件需要分类存储，直接在模型里自定义附件的key生成规则就好，完全对应你想要的「按模型名称分类」的需求。

比如你的User模型，修改has_one_attached的配置：

# app/models/user.rb
class User < ApplicationRecord
  has_one_attached :resume_attachment do |attachable|
    # 自定义路径：模型复数名/附件复数名/唯一安全token
    attachable.key = -> { "users/resume_attachments/#{ActiveStorage::Blob.generate_unique_secure_token}" }
  end
end

这样配置后，用户上传的简历附件会直接存在S3的users/resume_attachments/子目录下，后面的唯一token保证文件名不会重复，和ActiveStorage默认的安全机制保持一致。

方案二：全局复用配置（多模型通用） #

如果多个模型都需要遵循「模型名/附件名」的目录规则，把逻辑提取成Rails Concern会更省心：

1. 创建一个Concern文件：

# app/models/concerns/active_storage_custom_paths.rb
module ActiveStorageCustomPaths
  extend ActiveSupport::Concern

  class_methods do
    def has_one_attached_with_custom_path(name, **options)
      has_one_attached name, **options do |attachable|
        model_plural = self.model_name.plural
        attach_plural = name.to_s.pluralize
        attachable.key = -> { "#{model_plural}/#{attach_plural}/#{ActiveStorage::Blob.generate_unique_secure_token}" }
      end
    end
  end
end

2. 在模型里引用并使用这个自定义方法：

# app/models/user.rb
class User < ApplicationRecord
  include ActiveStorageCustomPaths

  has_one_attached_with_custom_path :resume_attachment
end

# app/models/company.rb
class Company < ApplicationRecord
  include ActiveStorageCustomPaths

  has_one_attached_with_custom_path :logo
end

这样User的简历会存在users/resume_attachments/，Company的logo会存在companies/logos/，完美复刻Paperclip的目录结构。

方案三：全局统一修改（适合加公共前缀） #

如果想要给所有ActiveStorage附件统一加个公共路径前缀（比如active_storage/），可以自定义S3服务类：

1. 创建自定义服务：

# app/services/active_storage/service/custom_s3_service.rb
class ActiveStorage::Service::CustomS3Service < ActiveStorage::Service::S3Service
  private

  def path_for(key)
    # 给所有附件路径加上公共前缀
    "active_storage/#{key}"
  end
end

2. 修改config/storage.yml使用自定义服务：

amazon:
  service: CustomS3
  access_key_id: <%= Rails.application.credentials.dig(:aws, :access_key_id) %>
  secret_access_key: <%= Rails.application.credentials.dig(:aws, :secret_access_key) %>
  bucket: your-bucket-name
  region: your-region

3. 在环境配置里指定这个服务：

# config/environments/production.rb
config.active_storage.service = :amazon

不过这种方式不太适合按模型分类的场景，因为path_for方法只能拿到文件key，没法直接关联到模型信息，所以还是前面两种模型级的方案更贴合你的需求。

测试的时候上传个附件，去S3控制台看看，文件应该已经乖乖躺在对应的子目录里啦～

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