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/），其上下文路径与文件系统物理结构不一致，导致路径解析失败。
✅ 正确做法分两类：
1. 图片存放在 storage/app/public/img/（推荐用于用户上传、动态内容）
- 先确保已执行软链接命令：
php artisan storage:link
该命令将 public/storage 指向 storage/app/public，使该目录可通过 Web 访问。
- 在 Blade 中使用 url() 辅助函数生成对应 URL：
<img src="{{ url('storage/img/netflix_logo.png') }}" alt="Netflix Logo" />✅ 解析为：http://your-app.test/storage/img/netflix_logo.png
⚠️ 注意：url() 默认以当前应用 URL 为前缀，无需手动拼接 /public 或协议。
2. 图片存放在 public/img/（适用于前端静态资源，如 logo、icon）
- 此目录天然可被 Web 服务器直接访问，无需软链接。
- 推荐使用 asset() 辅助函数（更简洁、自动处理 HTTPS/CDN 等配置）：
<img src="{{ asset('img/netflix_logo.png') }}" alt="Netflix Logo" />✅ 等价于 {{ 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 或原生相对路径。
