Laravel项目图片无法加载问题排查求助

• 检查软链接有效性
  虽然php artisan storage:link提示链接已存在，但可能是无效死链。手动删除public/storage软链接后重建：

  • Linux/macOS：执行 rm public/storage
  • Windows：直接删除public目录下的storage快捷方式
    重新执行 php artisan storage:link

• 验证文件存储路径
  确认图片实际存在于storage/app/public/对应的子目录中，比如视图引用storage/posts/xxx.jpg，则文件必须在storage/app/public/posts/xxx.jpg，路径不匹配会导致加载失败。

• 修正文件权限
  确保storage和public目录有正确的读写权限：

  chmod -R 755 storage/ public/
  

  服务器环境下，还需确保目录所属用户与web服务器用户一致（如www-data）：

  chown -R www-data:www-data storage/ public/
  

• 核对APP_URL配置
  检查.env文件中的APP_URL是否与项目访问域名一致，本地开发通常为APP_URL=http://localhost:8000，线上环境填写实际域名，该配置影响辅助函数生成的图片链接正确性。

• 规范视图图片引用
  使用Laravel内置辅助函数生成图片链接，避免硬编码：

  // 方式1：asset辅助函数
  <img src="{{ asset('storage/posts/' . $post->image) }}" alt="{{ $post->title }}">
  // 方式2：Storage门面的url方法
  <img src="{{ Storage::url('posts/' . $post->image) }}" alt="{{ $post->title }}">
  

• 清除项目缓存
  缓存可能导致路径解析异常，执行以下命令清理：

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

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