Rails 7如何显示存储在应用外部路径的图片？

问题原因 #

你直接在视图里使用本地绝对路径（/Users/adam/gallery/xxx.jpg）时，浏览器会将其解析为服务器根路径下的资源，向Rails服务器发起GET请求，但Rails路由中没有匹配该路径的规则，因此产生RoutingError。虽然本地浏览器可能能直接读取本地文件，但服务器端仍会记录错误请求。

解决方案 #

方法一：通过Rails控制器代理返回图片（推荐，适配生产环境规划） #

这种方式通过创建专属路由和控制器，让Rails作为中间层读取外部图片并返回给浏览器，既能解决开发环境的路由错误，也能无缝过渡到生产环境（仅需修改控制器逻辑适配独立存储服务）。

1. 添加路由
   在config/routes.rb中新增路由：

get 'gallery_images/:filename', to: 'gallery#show', as: 'gallery_image'

2. 创建Gallery控制器
   新建app/controllers/gallery_controller.rb，写入以下代码：

class GalleryController < ApplicationController
  def show
    # 拼接完整图片路径
    file_path = "/Users/adam/gallery/#{params[:filename]}"
    
    if File.exist?(file_path)
      # 自动匹配图片MIME类型，inline表示在浏览器中直接显示
      mime_type = Mime::Type.lookup_by_extension(File.extname(file_path)[1..])
      send_file file_path, type: mime_type, disposition: 'inline'
    else
      # 图片不存在时返回404
      head :not_found
    end
  end
end

3. 修改视图代码
   使用路由助手生成图片URL，替换原来的绝对路径：

<%= image_tag gallery_image_path(image.filename_path) %>

方法二：开发环境临时添加静态资源路径 #

如果只是开发环境临时使用，可以将外部图片目录加入Rails的静态资源路径，让Rails直接处理该目录下的资源请求：

1. 修改开发环境配置
   在config/environments/development.rb中添加：

# Rails 6+使用assets.paths，旧版本可尝试static_paths
config.assets.paths << "/Users/adam/gallery/"

2. 修改视图代码
   直接使用图片文件名生成URL：

<%= image_tag(image.filename_path) %>

注意：此方法仅适用于开发环境，生产环境不建议使用（生产环境静态资源通常经过预编译，且你计划使用独立存储服务）。

注意事项 #

• 确保Rails进程拥有读取/Users/adam/gallery/目录的权限
• 生产环境切换时，只需修改Gallery控制器的逻辑：比如将本地文件读取改为调用独立存储服务的API，或直接返回存储服务的图片URL，视图代码无需改动

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