Laravel 中图片无法显示通常源于路径配置错误：storage 目录需通过 storage:link 配合 url('storage/...') 访问，而 public 目录下的资源应直接使用相对路径或 URL::to('/') 构建绝对 URL。

laravel 中图片无法显示通常源于路径配置错误：`storage` 目录需通过 `storage:link` 配合 `url('storage/...')` 访问，而 `public` 目录下的资源应直接使用相对路径或 `url::to('/')` 构建绝对 url。

在 Laravel 项目中，静态资源的存放位置与访问方式有明确约定，不能直接使用 HTML 原生相对路径（如 ../img/netflix_logo.png），因为 Blade 模板最终渲染在 Web 服务器根目录（即 public/），其上下文路径与文件系统物理结构不一致，导致路径解析失败。

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

✅ 正确做法分两类：

1. 图片存放在 storage/app/public/img/（推荐用于用户上传、动态内容）

• 先确保已执行软链接命令：

  php artisan storage:link

  该命令将 public/storage 指向 storage/app/public，使该目录可通过 Web 访问。

• 在 Blade 中使用 url() 辅助函数生成对应 URL：

  @@##@@

  ✅ 解析为：http://your-app.test/storage/img/netflix_logo.png
  ⚠️ 注意：url() 默认以当前应用 URL 为前缀，无需手动拼接 /public 或协议。

2. 图片存放在 public/img/（适用于前端静态资源，如 logo、icon）

• 此目录天然可被 Web 服务器直接访问，无需软链接。
• 推荐使用 asset() 辅助函数（更简洁、自动处理 HTTPS/CDN 等配置）：

  @@##@@

  ✅ 等价于 {{ URL::to('/') }}/img/netflix_logo.png，但更语义化、更安全。
  ? asset() 会自动添加 APP_URL 前缀，并支持版本控制（配合 mix() 使用）。

❌ 常见错误排查

• 使用 ../img/...：Blade 不在子目录中渲染，.. 无意义；
• 忘记运行 php artisan storage:link：即使文件存在，storage/app/public/ 也无法通过 HTTP 访问；
• 路径大小写错误（尤其在 Linux 服务器上敏感）；
• 文件权限问题（storage/app/public 及其子目录需对 Web 用户可读）。

? 总结

始终根据图片来源选择访问方式：
? public/ 下 → 用 asset('path/to/file')；
? storage/app/public/ 下 → 先 storage:link，再用 url('storage/path/to/file')。
二者不可混用，且均应避免硬编码 URL 或原生相对路径。