使用Paperclip时image_tag无法显示图片但link_to正常，求原因

我在使用Spree框架搭配Paperclip gem时遇到了一个奇怪的问题：在购物车页面，用link_to可以正常显示商品的缩略图，但直接用image_tag就找不到图片。

可正常运行的代码： #

<% simple_current_order.line_items.all.each do |line_item| %>
<%= link_to mini_image(line_item.variant), product_path(line_item) %>
<% end %>

无法运行的代码： #

<% simple_current_order.line_items.all.each do |line_item| %>
<%= image_tag mini_image(line_item.variant) %>
<% end %>

以下是我的Image.rb模型代码：

module Spree
  class Image < Asset
    validate :no_attachment_errors
    has_attached_file :attachment, styles: { mini: '48x48>', small: '100x100>', product: '240x240>', large: '600x600>' }, default_style: :product, url: '/spree/products/:id/:style/:basename.:extension', path: ':rails_root/public/spree/products/:id/:style/:basename.:extension', convert_options: { all: '-strip -auto-orient -colorspace sRGB' }
    validates_attachment :attachment, :presence => true, :content_type => { :content_type => %w(image/jpeg image/jpg image/png image/gif) }

    # save the w,h of the original image (from which others can be calculated)
    # we need to look at the write-queue for images which have not been saved yet
    after_post_process :find_dimensions

    #used by admin products autocomplete
    def mini_url
      attachment.url(:mini, false)
    end

    def find_dimensions
      temporary = attachment.queued_for_write[:original]
      filename = temporary.path unless temporary.nil?
      filename = attachment.path if filename.blank?
      geometry = Paperclip::Geometry.from_file(filename)
      self.attachment_width = geometry.width
      self.attachment_height = geometry.height
    end

    # if there are errors from the plugin, then add a more meaningful message
    def no_attachment_errors
      unless attachment.errors.empty?
        # uncomment this to get rid of the less-than-useful interim messages
        # errors.clear
        errors.add :attachment, "Paperclip returned errors for file '#{attachment_file_name}' - check ImageMagick installation or image source file."
        false
      end
    end
  end
end

问题分析与解决方案 #

你遇到的核心问题，大概率是传给image_tag的参数不是正确的图片URL，而是其他类型的对象或HTML字符串，下面分几种常见情况给出解决办法：

1. 先确认mini_image方法的返回值 #

先在视图里临时加一行代码，看看mini_image到底返回了什么：

<%= mini_image(line_item.variant).inspect %>

根据输出结果对应调整：

情况A：mini_image已经返回了<img>标签HTML

如果mini_image是自定义的helper方法，内部已经调用了image_tag生成完整的图片标签（比如类似def mini_image(variant); image_tag variant.images.first.mini_url; end），那你根本不需要在外层再包一层image_tag，直接调用即可：

<% simple_current_order.line_items.all.each do |line_item| %>
<%= mini_image(line_item.variant) %>
<% end %>

之前link_to能正常工作，是因为link_to可以接受HTML字符串作为链接内容；而你错误地把这个HTML字符串传给image_tag，会导致生成嵌套的<img>标签，浏览器无法正确解析。

情况B：mini_image返回的是Spree::Image对象

如果mini_image返回的是图片实例（比如获取variant的第一张图片），那你需要调用模型里定义的mini_url方法拿到正确的URL，再传给image_tag：

<% simple_current_order.line_items.all.each do |line_item| %>
<%= image_tag mini_image(line_item.variant).mini_url %>
<% end %>

或者直接跳过mini_image，直接从variant获取图片URL（更直观）：

<% simple_current_order.line_items.all.each do |line_item| %>
<%= image_tag line_item.variant.images.first&.attachment&.url(:mini) %>
<% end %>

这里的&.是Ruby的安全导航操作符，避免当商品没有图片时出现nil报错。

2. 检查URL路径是否正确 #

你的模型中mini_url方法用了attachment.url(:mini, false)，第二个参数false表示生成不带主机的相对路径。如果你的应用不是部署在根域名下，或者开发环境有特殊路径配置，可能需要改成生成完整绝对URL：

# 在Image模型中修改mini_url方法
def mini_url
  attachment.url(:mini) # 去掉false参数，默认生成带主机的完整URL
end

或者在视图中用asset_url包裹路径，确保资源能被正确定位：

<%= image_tag asset_url(mini_image(line_item.variant).mini_url) %>

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