Rails 7.0.4 API：服务器更新后Active Storage上传图片无法显示

一、验证Active Storage磁盘配置 #

• 检查config/storage.yml的本地存储配置，确认root路径是否正确。如果是应用外路径，必须用绝对路径，同时确保部署用户对该目录有读写权限：

  local:
    service: Disk
    root: /var/app/shared/storage # 用绝对路径替代相对路径
  

• 执行rails active_storage:update，确保active_storage_blobs和active_storage_attachments表结构是最新的，避免部署时迁移遗漏。

二、排查部署流程的目录与权限问题 #

• 若用Capistrano这类部署工具，确认shared/storage的软链接是否在current目录下正常存在，且每次部署后没有被覆盖。软链接命令示例：

  ln -nfs /var/app/shared/storage /var/app/current/storage
  

• 若用Docker，检查宿主机与容器的存储目录挂载是否一致，新版本容器不要修改挂载路径，否则会找不到旧文件。

三、核对Blob记录与实际文件的关联 #

• 从active_storage_blobs表中取出无法访问图片的key字段，到存储目录中核对文件路径（格式为root/[key前2位]/[key中间2位]/[key]），确保文件存在且路径完全匹配。
• 在Rails控制台验证signed_id是否有效：

  # 替换成你生成的signed_id
  blob = ActiveStorage::Blob.find_signed("abcdefghijklmnopqrstuvwxyz123456")
  

  如果返回nil或报错，说明签名密钥不一致，这是最常见的原因。

四、修复签名密钥不一致问题 #

• 确保新版本服务器的RAILS_MASTER_KEY和旧版本完全相同，或者同步旧版本的config/credentials.yml.enc文件到新服务器。因为Active Storage的signed_id依赖这个密钥签名，密钥变更会导致解析失败返回404。
• 若用环境变量管理密钥，确认新版本服务器的RAILS_MASTER_KEY环境变量值和旧版本一致。

五、检查反向代理配置 #

• 如果你用Nginx/Apache，确认/rails/active_storage/路径没有被拦截，代理配置要正确转发请求到Rails应用。Nginx示例配置：

  location /rails/active_storage/ {
    proxy_pass http://your_rails_upstream;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
  

• 重启反向代理服务器，确保配置生效。

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