升级至Ruby on Rails 6.0后缩略图显示异常问题求助

问题根源 #

Rails 6.0 的 ActiveStorage 新增了文件完整性校验机制：生成变体时会下载原 Blob 文件，对比 active_storage_blobs 表中存储的 checksum（MD5 摘要的 Base64 编码）和 byte_size 字段。你用 mogrify 事后修改了存储目录中的原文件，导致文件内容、大小与数据库记录不匹配，触发了 ActiveStorage::IntegrityError。而 Rails 5.2 无此校验逻辑，所以之前未出现该问题。

针对新上传文件的解决方案 #

方案1：规范处理流程（推荐） #

放弃直接修改原 Blob 文件的脚本，改用 ActiveStorage 原生变体机制处理图片压缩：

• 上传时直接处理：在文件上传阶段就生成低质量版本作为原文件，或同步生成压缩变体。示例代码：

  # 在模型中定义变体（假设模型有 has_one_attached :image）
  def compressed_image
    image.variant(resize: "1920x1920>", quality: 70).processed
  end
  

  模板中直接使用该变体：

  <%= link_to image_tag(@ticket.compressed_image), @ticket.image %>
  

• 异步批量处理：对新上传的文件，用后台任务（如 Sidekiq）触发变体生成并存储，避免实时处理阻塞请求：

  # 后台任务示例
  class CompressImageJob < ApplicationJob
    queue_as :image_processing
  
    def perform(blob_id)
      blob = ActiveStorage::Blob.find(blob_id)
      blob.variant(resize: "1920x1920>", quality: 70).processed
    end
  end
  
  # 上传完成后触发任务
  after_create_commit :trigger_compression
  
  def trigger_compression
    CompressImageJob.perform_later(image.blob.id) if image.attached?
  end
  

方案2：禁用完整性校验（应急方案） #

如果暂时无法修改脚本，可关闭 ActiveStorage 的下载校验：

# config/initializers/active_storage.rb
Rails.application.config.active_storage.verify_downloads = false

⚠️ 注意：此方案会失去文件篡改检测能力，存在安全风险，仅建议临时过渡使用。

方案3：同步修改后的文件信息（兼容原有脚本） #

若坚持保留事后修改原文件的脚本，需在修改后同步更新数据库记录：

1. 修改文件后，计算新的校验和与文件大小：

   # 计算MD5摘要的Base64编码（ActiveStorage存储格式）
   md5_digest=$(md5sum /path/to/modified/file | awk '{print $1}' | xxd -r -p | base64)
   # 计算文件大小
   file_size=$(wc -c /path/to/modified/file | awk '{print $1}')
   

2. 更新对应 Blob 记录：

   blob = ActiveStorage::Blob.find(blob_id)
   blob.update!(
     byte_size: file_size.to_i,
     checksum: md5_digest
   )
   

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