rails_admin搭配Paperclip无法上传至S3问题求助

我之前也踩过类似的坑——明明配置看起来全对，但文件就是固执地存在本地，咱们一步步拆解排查：

1. 确认Rails Admin是否继承了Paperclip的S3配置 #

Rails Admin有时候不会自动沿用全局Paperclip配置，你需要在config/initializers/rails_admin.rb里给对应模型明确指定存储规则：

RailsAdmin.config do |config|
  # 保留你原有的其他配置...
  config.model YourModelName do
    edit do
      field :your_attachment_field do
        storage :s3 # 强制绑定S3存储
      end
    end
  end
end

记得把YourModelName和your_attachment_field替换成你实际的模型名和附件字段名。

2. 验证全局配置是否真正生效 #

打开Rails控制台（rails c），直接查看Paperclip的默认配置：

# 检查存储方式是否为S3
Paperclip::Attachment.default_options[:storage]
# 检查S3凭证是否正确读取
Paperclip::Attachment.default_options[:s3_credentials]

如果返回的是:filesystem，说明你的paperclip.rb初始化文件要么没被加载，要么被其他配置覆盖了。

3. 检查模型代码是否覆盖了全局配置 #

看看你的模型里，has_attached_file有没有硬指定本地存储？比如这种错误写法：

# 会直接覆盖全局S3配置
has_attached_file :avatar, storage: :filesystem

如果有，删掉storage: :filesystem这个选项，让模型继承全局的S3配置。

4. 确认当前环境的配置没有冲突 #

检查对应环境的配置文件（比如config/environments/development.rb），有没有单独覆盖Paperclip的默认设置：

# 这种配置会直接干掉全局的S3设置，一定要删掉
config.paperclip_defaults = { storage: :filesystem }

另外还要确认Settings模块是否正确读取了配置值——比如你用的Settings.s3.bucket_name这些参数，在当前环境下是不是真的拿到了正确的S3信息。

5. 查看日志定位问题 #

启动服务器后上传文件，盯着log/development.log（对应环境的日志）看：

• 如果看到[paperclip] Saving attachments to local filesystem，说明配置完全没生效，回到前面的步骤排查配置加载问题；
• 如果看到S3相关的请求日志但上传失败，那可能是S3权限、密钥或者区域配置错误。

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