Rails API结合Active Storage上传S3后返回链接404问题排查

问题分析与解决步骤 #

1. service_url 报未定义方法的解决 #

Rails 7 里，Active Storage 的 Attachment 对象不再直接提供 service_url 方法，换成了 url 方法封装服务端URL生成逻辑。直接用下面的写法即可：

# 生成带过期时间的预签名URL（推荐，适配私有对象）
@user.avatar.url(expires_in: 1.hour)
# 若S3对象设置为公开可读，可使用此写法
@user.avatar.url(disposition: 'inline')

2. 生产环境重定向链接404的主要原因 #

你拿到的 /rails/active_storage/blobs/redirect/... 是Active Storage的重定向链接，会跳转到S3的实际文件地址。出现404通常是以下问题导致：

原因一：S3桶CORS配置错误

S3必须允许你的API和前端域名发起重定向请求，否则浏览器会拦截跳转。前往S3控制台的桶权限页面配置CORS规则，示例：

<CORSConfiguration>
  <CORSRule>
    <AllowedOrigin>https://你的前端域名.com</AllowedOrigin>
    <AllowedOrigin>https://api.sometestpage.com</AllowedOrigin>
    <AllowedMethod>GET</AllowedMethod>
    <AllowedHeader>*</AllowedHeader>
    <MaxAgeSeconds>3000</MaxAgeSeconds>
  </CORSRule>
</CORSConfiguration>

原因二：S3对象为私有，重定向链接未签名

默认情况下，Active Storage上传到S3的文件是私有的，重定向链接需要预签名才能访问，但url_for生成的重定向链接在生产环境可能未正确生成签名，或签名已过期。改用上面直接生成S3预签名URL的方式，绕过重定向逻辑，直接返回可访问地址即可解决。

原因三：生产环境Rails路由host未配置

确保config/environments/production.rb中配置了正确的host和协议：

Rails.application.routes.default_url_options[:host] = 'api.sometestpage.com'
Rails.application.routes.default_url_options[:protocol] = 'https'

虽然你拿到的链接host看起来正确，但缺失此配置可能导致重定向逻辑异常。

原因四：Blob记录与S3文件不匹配

如果手动修改过S3桶内文件，或迁移过数据，可能导致数据库中的Active Storage Blob记录与S3实际文件不匹配。可在Rails控制台验证：

# 执行以下代码
blob = @user.avatar.blob
# 检查S3是否存在对应文件
Aws::S3::Client.new.head_object(bucket: 'my-bucket-production', key: blob.key)
# 若报错NoSuchKey，说明文件不存在，需重新上传

3. 推荐的代码修改 #

将user_info方法改为直接生成S3预签名URL，避开重定向的坑：

def user_info
  c = @user.as_json(only: %i[id email role username])
  if @user.avatar.attached?
    c.merge!(avatar_path: @user.avatar.url(expires_in: 24.hours))
  end
  c
end

额外检查点 #

• 确认storage.yml中的region和bucket名称完全正确，生产环境使用的AWS凭证拥有S3读写权限。
• 检查生产环境是否设置了RAILS_ENV=production，且config/environments/production.rb中配置了config.active_storage.service = :amazon，确保加载S3存储服务。

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