Laravel 9部署环境下部分场景图片无法显示问题求助

1. 验证存储软链接的有效性 #

• 部署环境中，php artisan storage:link可能因权限问题未成功创建软链接，手动在服务器执行：

  ln -s /你的项目绝对路径/storage/app/public /项目目录/public/storage
  

• 检查public/storage软链接是否存在，且目录权限为755，文件所有者与Web服务器运行用户（如www-data）一致。

2. 清除应用缓存与静态资源缓存 #

• 执行以下命令清除配置、缓存和视图缓存：

  php artisan config:clear
  php artisan cache:clear
  php artisan view:clear
  

• 若使用CDN或反向代理，需手动清除CDN缓存，避免新图片被旧缓存覆盖。

3. 检查新上传文件的权限 #

• Laravel上传文件后可能权限不足，可在存储后手动设置权限：

  $path = $file->store('profilepics', 'public');
  $fullPath = storage_path('app/public/' . $path);
  chmod($fullPath, 0644); // 根据服务器环境调整，也可尝试0755
  $formFields['profilepic'] = $path;
  

4. 确认APP_URL配置正确性 #

• 检查.env文件中的APP_URL是否设置为部署后的完整域名，例如：

  APP_URL=https://your-production-domain.com
  

  asset函数依赖此配置生成正确的图片访问URL，配置错误会导致新图片路径无效。

5. 调整Web服务器配置 #

• 若使用Nginx，在server配置块中添加存储目录的访问规则：

  location /storage {
      try_files $uri $uri/ /index.php?$query_string;
      allow all;
  }
  

• 重启Nginx使配置生效：

  sudo systemctl restart nginx
  

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