Rails 7.0.4 API模式下Active Storage旧图片无法显示求助

可能的原因及修复步骤 #

1. 检查磁盘存储路径与权限 #

服务器更新后，存储路径或权限变更常导致旧文件无法访问：

• 打开config/storage.yml确认local配置的根路径：

  local:
    service: Disk
    root: <%= Rails.root.join("storage") %>
  

• 核对服务器上storage目录的实际位置，确保旧图片文件仍存在于该目录下。若部署路径变更，需将旧storage目录迁移至新Rails根目录，或修改root配置指向旧存储路径。
• 检查目录和文件权限：Rails运行用户需对storage目录有读权限，文件权限设为644、目录设为755。

2. 验证Active Storage路由配置 #

API模式下需手动挂载Active Storage路由，服务器更新后可能丢失：

• 打开config/routes.rb，确认包含以下代码：

  Rails.application.routes.draw do
    # 其他路由...
    mount ActiveStorage::Engine => '/rails/active_storage'
  end
  

• 若缺失该路由，旧图片的/rails/active_storage/blobs/...路径会返回404，添加后重启服务器测试。

3. 检查Blob记录与文件的匹配性 #

数据库中Active Storage的Blob记录可能在更新过程中损坏：

• 启动Rails控制台：rails c
• 通过关联模型查询旧图片的Blob：user = User.find(1); blob = user.avatar.blob
• 核对blob.key对应的文件是否存在于storage目录（路径格式为storage/[key前两位]/[完整key]）。若文件存在但key不匹配，需修正数据库中Blob的key字段，或重新关联文件。

4. 清除缓存 #

Rails或反向代理的缓存可能导致旧路径无法更新：

• 执行命令清除Rails缓存：rails cache:clear
• 若使用Nginx等反向代理，同步清除代理缓存，确保请求能正确到达Rails服务器。

5. 检查服务器转发配置 #

若服务器将/rails/active_storage路径误判为静态文件，会导致请求无法转发到Rails：

• 以Nginx为例，确认配置包含正确的转发规则：

  location /rails/active_storage {
    proxy_pass http://your_rails_server;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
  }
  

• 确保该路径未被指向静态文件目录，而是转发至Rails应用。

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