Rails7生产环境图片alt属性显示数字而非实际文件名问题

问题原因 #

生产环境下，Active Storage为优化缓存策略、避免文件命名冲突，会将存储文件重命名为哈希格式（如1000043.jpg）。你遇到的store.main_image.filename返回哈希名而非原始上传文件名的情况，通常是因为：

• 数据库active_storage_blobs表的filename字段被错误设置为存储用的哈希key，而非原始文件名
• 上传逻辑中自定义覆盖了原始文件名的保存规则

解决方案 #

1. 修正视图中的文件名获取方式 #

确保调用原始文件名的正确属性：

<img class="card-img-top" alt="<%= store.main_image.filename.to_s %>" draggable="false" src="<%= my_store_url(store) %>" />

store.main_image.filename返回的是ActiveStorage::Filename对象，调用to_s可获取完整的原始文件名（含扩展名）。如果生产环境仍返回哈希名，说明数据库中filename字段值异常，需进一步处理。

2. 修复数据库中已存储的Blob记录 #

若生产环境数据库的Blob记录filename字段被错误设置为哈希key，可通过脚本从metadata中恢复原始文件名：

# 在Rails控制台或迁移脚本中执行
ActiveStorage::Blob.find_each do |blob|
  original_filename = blob.metadata[:filename]
  if original_filename && blob.filename.to_s != original_filename
    blob.update!(filename: original_filename)
  end
end

默认情况下，Active Storage会将原始文件名存在Blob的metadata[:filename]中，该脚本可批量修正已有记录。

3. 检查并修正上传逻辑 #

确保上传代码未自定义覆盖原始文件名的保存：

# 错误示例：手动将filename设为存储key
store.main_image.attach(io: file, filename: file.key)

# 正确示例：让Active Storage自动处理原始文件名
store.main_image.attach(io: file, filename: file.original_filename)

直接调用attach方法传入文件对象，Active Storage会自动提取并保存原始文件名。

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