Rails使用Prawn从Active Storage插入图片时颜色异常求助

问题原因 #

PDF默认使用CMYK颜色空间，而网页及多数图片采用RGB颜色空间，Prawn直接插入RGB图片时未自动转换颜色空间，导致输出PDF中颜色出现偏差。

解决方案：用MiniMagick转换颜色空间 #

通过MiniMagick将Active Storage中的图片转换为适配PDF的颜色空间后再插入，具体步骤如下：

1. 确认依赖安装 #

确保Gemfile中已添加MiniMagick：

gem 'mini_magick'

执行bundle install完成安装。

2. 处理图片并插入PDF #

在Prawn的PDF生成逻辑中，先下载Active Storage图片、转换颜色空间，再插入到PDF：

# 假设你的Active Storage关联为 model.image
image_blob = model.image.blob
temp_file = Tempfile.new(["converted_img", ".png"])

# 用MiniMagick移除干扰的ICC配置文件并转换为CMYK
MiniMagick::Tool::Convert.new do |convert|
  convert << image_blob.service.path_for(image_blob.key)
  convert.profile("*") # 移除所有嵌入的ICC配置文件
  convert.colorspace("CMYK")
  convert << temp_file.path
end

# 在PDF中插入转换后的图片，可按需调整宽度
pdf.image(temp_file.path, width: 200)

# 清理临时文件
temp_file.close!

3. 备选调整：显式指定渲染颜色空间 #

若转换后仍有异常，尝试在插入图片时显式声明颜色空间：

pdf.image(temp_file.path, width: 200, colorspace: :cmyk)

测试建议 #

• 若原图本身是CMYK格式，可跳过颜色空间转换，仅移除ICC配置文件测试
• 对比转换前后的颜色效果，必要时尝试使用指定的SRGB转CMYK ICC配置文件（需提前准备对应文件）

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