Rails7中使用image_processing与mini_magick生成Active Storage图片变体报错

问题重现 #

模型代码 #

class ProjectImage < ApplicationRecord
  belongs_to :project

  has_many_attached :images do |attachable|
    attachable.variant :thumb, resize_to_limit: [100, 100], saver: { quality: 80 }
    attachable.variant :medium, resize_to_limit: [800, 800], saver: { quality: 75 }
  end
end

Gemfile 依赖 #

gem 'image_processing', '~> 1.2'
gem 'mini_magick'

错误信息 #

/home/dinesh/.rvm/gems/ruby-3.2.0@ruby-3.2.0my_app/gems/image_processing-1.2.0/lib/image_processing/chainable.rb:15:in `saver': wrong number of arguments (given 1, expected 0) (ArgumentError)

在控制台尝试生成变体时，无论是通过ActiveStorage Attachment直接调用，还是读取本地文件调用ImageProcessing::MiniMagick，都会触发相同的参数不匹配错误。

错误原因 #

image_processing 1.2.0 版本的 saver 方法不接受参数，你在变体定义中传递了saver: { quality: 80 }这种哈希参数，导致方法调用时参数数量不匹配。同时该版本的ImageProcessing::MiniMagick链式调用写法也有兼容性限制。

解决方案 #

方案1：升级 image_processing 版本（推荐） #

将image_processing升级到支持saver参数或直接支持quality参数的版本（建议 >= 1.10.0）：

1. 修改Gemfile：

gem 'image_processing', '~> 1.10'
gem 'mini_magick'

2. 执行更新命令：

bundle update image_processing

3. 简化变体定义（新版本支持直接写quality参数）：

class ProjectImage < ApplicationRecord
  belongs_to :project

  has_many_attached :images do |attachable|
    attachable.variant :thumb, resize_to_limit: [100, 100], quality: 80
    attachable.variant :medium, resize_to_limit: [800, 800], quality: 75
  end
end

方案2：适配旧版本 image_processing 1.2.0 #

如果无法升级，调整变体定义的写法，去掉saver参数，使用块式调用添加处理步骤：

class ProjectImage < ApplicationRecord
  belongs_to :project

  has_many_attached :images do |attachable|
    attachable.variant :thumb do |v|
      v.resize_to_limit(100, 100)
      v.quality(80)
    end
    attachable.variant :medium do |v|
      v.resize_to_limit(800, 800)
      v.quality(75)
    end
  end
end

同时，控制台生成变体的正确写法（适配1.2.0版本）：

# 从本地文件生成并保存
file = ActiveStorage::Blob.service.send(:path_for, image.key)
processed = ImageProcessing::MiniMagick.source(file)
  .resize_to_limit(800, 800)
  .quality(75)
  .call
File.write('/tmp/processed_image.jpg', processed)

验证 #

修改完成后，在控制台重新执行以下代码验证：

include Rails.application.routes.url_helpers
Rails.application.routes.default_url_options[:host] = 'localhost:3000'

project_image = ProjectImage.last
project_image.images.each do |image|
  original_url = url_for(image)
  thumbnail_url = url_for(image.variant(:thumb).processed)
  medium_url = url_for(image.variant(:medium).processed)

  puts "Original: #{original_url}"
  puts "Thumbnail: #{thumbnail_url}"
  puts "Medium: #{medium_url}"
end

此时应该能成功生成图片变体并输出对应的URL。

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