Ruby on Rails Active Storage图片URL异常问题求助（Nginx+Passenger）

问题根源 #

1. url_for的上下文依赖特性：url_for是通用路由助手，处理Active Storage Blob对象时，会根据当前请求上下文、Blob的缓存状态甚至Passenger进程的路由缓存动态生成URL。当Blob刚上传、缓存未同步，或者不同Passenger进程加载状态不一致时，可能直接生成指向存储后端（比如disk存储）的/rails/active_storage/disc/...路径；而缓存生效后，会生成通过Rails控制器转发的/rails/active_storage/blobs/...路径，这就是URL忽变的核心原因。
2. Nginx+Passenger的缓存/进程隔离：Passenger的多进程模式下，不同进程可能持有不同的路由缓存状态，加上Nginx对静态资源的缓存策略，会导致同一请求被不同进程处理时返回不同URL；刷新后进程缓存同步，URL恢复正常。
3. url_for对Active Storage的支持优先级低：相比于Active Storage专用的路由助手，url_for对Blob对象的处理没有做特殊优化，容易出现路径生成的歧义。

解决办法 #

• 推荐使用官方简洁写法：直接用image_tag event.logo，Rails内部会自动调用Active Storage的专用逻辑生成稳定的blobs路径，完全规避url_for带来的上下文问题。
• 专用路由助手生成路径：如果需要单独获取图片路径，使用Rails.application.routes.url_helpers.rails_blob_path(event.logo, only_path: true)（生成相对路径）或rails_blob_url(event.logo)（生成完整URL），这是Active Storage提供的专属方法，路径生成逻辑稳定，不受上下文干扰。
• 环境配置检查：
  • 确认config/storage.yml中disk服务的public配置：如果是私有存储，需设置public: false，强制走blobs路由；如果是公开存储，public: true会生成直接存储路径，但需确保Nginx能正确访问存储目录。
  • 调整Nginx配置，确保/rails/active_storage/blobs路径完全转发给Passenger，避免被当作静态资源拦截：

    location /rails/active_storage/blobs {
      passenger_enabled on;
      rails_env production;
    }
    

  • 重启Passenger和Nginx，清理进程缓存，确保所有进程加载一致的路由规则。

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