Rails 5.2如何通过Active Storage获取S3存储的附件真实URL

你遇到的问题很典型——rails_blob_url生成的是Rails应用的代理链接，而非直接的S3文件URL，而且在Sidekiq这类无请求上下文的后台任务里，它默认会用localhost作为主机，导致链接无法在外部环境正常使用。下面是具体的解决步骤：

1. 配置S3存储服务（按需选择公开/私有模式） #

首先调整你的S3存储配置，决定是生成永久公开URL还是临时签名URL：

若需要永久公开URL #

编辑config/storage.yml中的S3配置，开启public: true——这样Active Storage会自动将上传的文件设置为public-read权限，直接生成S3公开链接：

s3:
  service: S3
  access_key_id: <%= ENV['AWS_ACCESS_KEY_ID'] %>
  secret_access_key: <%= ENV['AWS_SECRET_ACCESS_KEY'] %>
  region: <%= ENV['AWS_REGION'] %>
  bucket: <%= ENV['AWS_BUCKET'] %>
  public: true # 关键配置：开启公开访问

同时在对应环境配置文件（比如config/environments/production.rb）中指定使用S3服务：

config.active_storage.service = :s3

若需要保持文件私有 #

无需设置public: true，后续通过生成临时签名URL访问即可。

2. 在Sidekiq任务中使用service_url获取真实URL #

放弃rails_blob_url，改用Active Storage Blob的service_url方法——这个方法直接与S3交互生成URL，完全不依赖请求上下文。

示例代码（针对带附件的模型）： #

# Sidekiq任务中的代码
class GenerateZipJob
  include Sidekiq::Job

  def perform(document_id)
    document = Document.find(document_id)
    # 获取直接的S3文件URL
    real_s3_url = document.file.service_url

    # 接下来用这个URL执行压缩包生成逻辑即可
    # ...你的压缩代码...
  end
end

私有文件的临时签名URL #

如果文件需要保持私有，给service_url加上过期时间参数，生成临时有效签名URL：

# 生成24小时内有效的临时访问链接
real_s3_url = document.file.service_url(expires_in: 24.hours)

为什么rails_blob_url不行？ #

rails_blob_url是Rails的路由辅助方法，它生成的是应用内部的代理链接（比如你得到的http://localhost:3000/rails/active_storage/blobs/...），用户访问这个链接时，Rails会转发请求到S3。但在Sidekiq后台任务中，没有请求上下文，Rails无法获取正确的主机地址，所以默认用localhost，导致这个链接在外部无法访问。

额外注意事项 #

• 如果你之前在public: false配置下上传过文件，这些文件仍为私有状态，需要手动修改S3对象的ACL为public-read，或者使用临时签名URL访问。
• 若你的压缩服务需要跨域访问S3文件，确保S3 bucket的CORS配置允许对应的域名请求。

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