Ruby on Rails：如何通过form_with获取目录路径供Active Storage导入图片

首先明确：浏览器的安全限制导致无法直接获取用户本地目录的真实路径，你用file_field :photos_path拿到临时路径是正常现象——当用户选择目录时，浏览器实际上是把目录内的文件逐个上传到服务器临时目录，而非暴露本地目录的绝对路径。

以下是几种可行的替代方案：

方案1：让用户上传目录压缩包（推荐） #

让用户把图片目录打包成ZIP文件上传，后台解压后记录解压路径，后续从该路径导入图片。

步骤： #

1. 添加rubyzip依赖到Gemfile：

gem 'rubyzip', require: 'zip'

执行bundle install安装。

2. 表单修改：

<%= form_with model: @report do |form| %>
  <%= form.file_field :data_file %> <!-- 原数据文件字段 -->
  <%= form.file_field :photos_zip, accept: '.zip' %> <!-- 新增压缩包字段 -->
  <%= form.submit %>
<% end %>

3. 控制器处理解压：

def create
  @report = Report.new(report_params)
  if params[:report][:photos_zip].present?
    # 创建临时解压目录
    unzip_dir = Rails.root.join('tmp', 'photos_uploads', SecureRandom.uuid)
    FileUtils.mkdir_p(unzip_dir)

    # 解压ZIP文件
    Zip::File.open(params[:report][:photos_zip].path) do |zip_file|
      zip_file.each do |entry|
        entry.extract(unzip_dir.join(entry.name)) unless entry.directory?
      end
    end

    # 记录解压后的目录路径（可存在数据库字段，比如photos_unzip_path）
    @report.photos_unzip_path = unzip_dir.to_s
  end

  if @report.save
    # 启动后台Job处理数据导入和图片上传
    ImportReportJob.perform_later(@report.id)
    redirect_to @report, notice: '报告已创建，导入任务已启动'
  else
    render :new
  end
end

private
def report_params
  params.require(:report).permit(:data_file, :photos_zip)
end

4. 后台Job中导入图片：

class ImportReportJob < ApplicationJob
  queue_as :default

  def perform(report_id)
    report = Report.find(report_id)
    # 先处理数据文件导入...

    # 从解压目录导入图片
    Dir.glob("#{report.photos_unzip_path}/*.jpg") do |image_path|
      image_name = File.basename(image_path, '.jpg')
      # 找到对应的数据记录
      record = ReportRecord.find_by(name: image_name)
      next unless record

      record.photo.attach(
        io: File.open(image_path),
        filename: "#{image_name}.jpg",
        content_type: 'image/jpeg',
        identify: false
      )
    end

    # 导入完成后可清理临时解压目录（可选）
    FileUtils.rm_rf(report.photos_unzip_path)
  end
end

方案2：让用户输入服务器可访问的目录路径 #

如果图片目录已经在服务器可访问的位置（比如共享存储、FTP挂载目录），可以让用户输入该目录的绝对路径，后台直接读取。

步骤： #

1. 表单修改：

<%= form_with model: @report do |form| %>
  <%= form.file_field :data_file %>
  <%= form.text_field :photos_directory, placeholder: '输入服务器上的图片目录路径，比如 /var/www/photos' %>
  <%= form.submit %>
<% end %>

2. 控制器验证路径安全性（关键！防止路径遍历攻击）：

def create
  @report = Report.new(report_params)
  if @report.photos_directory.present?
    # 限制路径必须在允许的安全目录内，比如 Rails.root.join('public', 'allowed_photos')
    allowed_root = Rails.root.join('public', 'allowed_photos')
    real_path = File.realpath(@report.photos_directory)
    unless real_path.start_with?(allowed_root.to_s)
      @report.errors.add(:photos_directory, '路径不在允许范围内')
      return render :new
    end
    @report.photos_directory = real_path
  end

  if @report.save
    ImportReportJob.perform_later(@report.id)
    redirect_to @report, notice: '报告已创建，导入任务已启动'
  else
    render :new
  end
end

private
def report_params
  params.require(:report).permit(:data_file, :photos_directory)
end

3. 后台Job中直接读取目录：

class ImportReportJob < ApplicationJob
  queue_as :default

  def perform(report_id)
    report = Report.find(report_id)
    # 处理数据文件导入...

    Dir.glob("#{report.photos_directory}/*.jpg") do |image_path|
      # 同方案1的图片上传逻辑
    end
  end
end

关键注意事项 #

• 安全优先：无论哪种方案，都要验证用户输入的路径/文件，避免恶意文件上传或路径遍历攻击。
• 临时文件清理：使用临时目录后记得在任务完成后清理，避免占用服务器磁盘空间。
• 权限设置：确保服务器对解压目录或指定目录有读写权限。

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