Rails部署Heroku后图片异常：如何检测assets中图片是否存在？

问题根源 #

在Rails生产环境（Heroku默认启用）下，Rails.application.assets对应的Sprockets运行时编译环境默认关闭（config.assets.compile = false），导致find_asset方法无法正常工作——生产环境依赖预编译后的静态资源文件，而非动态编译查找。而image_tag能正常显示存在的图片，是因为它直接使用预编译时生成的带指纹资源路径，指向public/assets目录下的文件，不需要动态检测。

可靠的检测方案 #

方案1：利用Asset Manifest文件检测 #

预编译完成后，Rails会生成public/assets/manifest-{fingerprint}.json文件，记录所有预编译资源的逻辑路径与实际文件路径的映射。可以通过Rails.application.assets_manifest查询资源是否存在：

在Helper中添加方法：

def badge_image_exists?(image_name)
  logical_path = "badges/#{image_name}"
  Rails.application.assets_manifest.files.key?(logical_path)
end

def valid_badge_image_path(image_name)
  badge_image_exists?(image_name) ? asset_path("badges/#{image_name}") : nil
end

在视图中使用：

<% if path = valid_badge_image_path(badge.image_name) %>
  <%= image_tag(path, alt: badge.name) %>
<% end %>

方案2：直接检查预编译后的文件路径 #

结合asset_path生成带指纹的路径，直接检查文件是否存在于Heroku的public/assets目录：

def badge_image_exists?(image_name)
  asset_file_path = Rails.root.join('public', asset_path("badges/#{image_name}"))
  File.exist?(asset_file_path)
end

注意：此方法依赖asset_path能正确生成带指纹路径，本质上和方案1依赖同一机制，需要manifest文件正常生成。

前置保障：确保所有Badge图片被预编译 #

为避免部分图片未纳入预编译流程，在config/initializers/assets.rb中明确指定需要预编译的Badge图片：

Rails.application.config.assets.precompile += %w( badges/*.png badges/*.jpg badges/*.jpeg badges/*.gif )

部署时Heroku执行assets:precompile会自动处理所有指定格式的Badge图片，确保它们出现在manifest文件中。

额外验证 #

部署后可通过Heroku命令行验证manifest文件是否包含目标图片：

heroku run cat public/assets/manifest*.json | grep "badges/your-image-name"

若能找到对应条目，说明预编译成功，检测方法可正常工作。

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