Active Storage调用variant报错：undefined method 'variant' for nil:NilClass

核心原因 #

遍历图片时未判断附件是否实际上传，或存在空的附件记录，导致调用variant时触发nil:NilClass错误。编辑页正常是因为编辑时已确保附件存在，而创建/列表页可能存在未上传成功的空附件或未判断附件状态。

具体解决步骤 #

1. 视图中添加附件存在判断 #

在遍历展示图片的代码里，用attached?方法检查附件是否真实上传，避免对空附件调用variant：

<% @article.photos.each do |photo| %>
  <% if photo.attached? %>
    <%= image_tag photo.photo_as_thumbnail %>
  <% end %>
<% end %>

2. 模型方法中增加安全判断 #

修改模型里的图片缩放方法，先判断附件是否存在再调用variant：

class Article < ApplicationRecord
  has_many_attached :photos

  def photo_as_thumbnail
    photos.map do |photo|
      photo.variant(resize_to_limit: [300, 300]) if photo.attached?
    end.compact
  end

  def photo_as_icon
    photos.map do |photo|
      photo.variant(resize_to_limit: [100, 100]) if photo.attached?
    end.compact
  end
end

3. 控制器过滤空附件参数 #

在创建文章时，过滤掉参数中可能存在的空附件记录，避免关联空对象：

def create
  @article = Article.new(article_params)
  # 过滤空附件
  @article.photos = @article.photos.reject { |p| p.blank? }
  if @article.save
    redirect_to articles_path, notice: '文章创建成功'
  else
    render :new
  end
end

private

def article_params
  params.require(:article).permit(:title, :content, photos: [])
end

4. 列表页预加载图片关联（可选） #

在列表控制器的index动作中预加载photos关联，提升性能同时避免加载异常：

def index
  @articles = Article.includes(:photos).all
end

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