生产环境下AWS S3存储GIF致Ruby on Rails应用崩溃问题排查

部署Ruby on Rails应用到fly.io后，碰到个生产环境独有的问题：存在AWS S3里的某张GIF会直接导致应用崩溃，但用本地存储时这张GIF完全正常。

错误日志先弹出VIPs-Warning error in tile 0 x 1104，接着就是ActionView::Template::Error (gifload: Image EOF detected before image complete)，明显是libvips处理GIF时出的问题。

当前加载图片的代码是：

<% if post.images.attached? %>
    <% post.images.each do |image| %>
    <%= image_tag image.representation(loader: { n: -1 }, resize_to_fit: [400, nil]).processed, class: "img-fluid" %>
<% end %>

之前试过两种方法都没用：

• 给image_tag加onerror属性：没用，因为错误发生在服务器端渲染阶段，前端压根没机会触发这个事件
• 直接加rescue nil：触发语法错误，这种写法不符合Ruby erb的规则

1. 服务器端捕获异常（核心方案） #

因为错误是服务器在处理representation.processed时抛出来的，必须在Ruby层面拦截：

直接在视图里加rescue块 #

把图片处理逻辑包裹在begin...rescue里，专门捕获libvips的异常，出错时要么渲染备用图，要么不显示：

<% if post.images.attached? %>
  <% post.images.each do |image| %>
    <% begin %>
      <%= image_tag image.representation(loader: { n: -1 }, resize_to_fit: [400, nil]).processed, class: "img-fluid" %>
    <% rescue Vips::Error => e %>
      <!-- 这里可以换成你的备用图片路径，或者直接留空 -->
      <%= image_tag "fallback-image.png", class: "img-fluid", alt: "图片加载失败" %>
      <!-- 记录错误日志方便排查 -->
      <% Rails.logger.error "处理图片ID #{image.id}失败: #{e.message}" %>
    <% end %>
  <% end %>
<% end %>

封装成Helper方法（更整洁） #

要是多个地方都要处理这种情况，把逻辑抽到Helper里更方便：
在app/helpers/posts_helper.rb里添加：

module PostsHelper
  def safe_image_tag(attachment, options = {})
    begin
      processed_image = attachment.representation(loader: { n: -1 }, resize_to_fit: [400, nil]).processed
      image_tag processed_image, options
    rescue Vips::Error => e
      Rails.logger.error "图片处理失败（ID:#{attachment.id}）: #{e}"
      image_tag "fallback-image.png", options.merge(alt: "图片加载失败")
    end
  end
end

然后在视图里直接调用：

<% if post.images.attached? %>
  <% post.images.each do |image| %>
    <%= safe_image_tag image, class: "img-fluid" %>
  <% end %>
<% end %>

2. 调整libvips加载参数 #

针对这个EOF错误，可以试试给loader加fail: false参数，让libvips忽略错误继续处理：

# 修改representation的loader配置
image.representation(loader: { n: -1, fail: false }, resize_to_fit: [400, nil]).processed

这个参数会让libvips遇到加载错误时不抛异常，而是返回一个损坏的图像对象，配合前端onerror就能隐藏坏图，不过还是建议和服务器端捕获一起用，更稳妥。

3. 排查环境版本差异 #

开发环境没问题，生产环境炸锅，大概率是libvips版本不一样：

• 查一下fly.io容器里的libvips版本，和本地开发环境对比
• 如果版本不同，在Dockerfile里指定和本地一致的版本，或者直接升级到最新稳定版，说不定新版本修复了这种特殊GIF的兼容性问题

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