Web服务器root必须指向public目录，否则asset()生成的静态资源路径无法被正确访问；图片路径须用asset()生成且不带public前缀，Linux下需注意大小写一致。
伪静态本身不改图片路径，但配置错会导致图片 404 —— 根本原因是 Web 服务器 root 没指向 public 目录，或 asset() 路径写法与实际文件位置不匹配。
Web 服务器 root 必须指向 public 目录
这是所有静态资源（包括图片）能被访问的前提。如果 root 指向项目根目录（含 app、config），浏览器请求 /static/images/logo.png 时，服务器会在错误位置找文件，直接返回 404。
- Apache：检查
.htaccess所在目录是否为public，且AllowOverride All已启用 - Nginx：确认
root指令值是/path/to/your/project/public，不是/path/to/your/project - 宝塔面板：网站设置 → 网站目录 → “网站目录”必须选到
public子目录
图片路径必须用 asset() 生成，不能手拼
手写 <img src="/static/images/logo.png"> 看似简单，但一旦部署到子目录（如 https://example.com/myapp/）或启用 CDN，就会失效。而 asset() 会自动适配当前环境。
- 正确写法：
{{ asset('static/images/logo.png') }}（模板中）或think\facade\Url::build('static/images/logo.png')（PHP 中） - 传入路径不能带
public/前缀 ——asset('public/static/...')是错的，asset()默认以public/为基准 - 如果图片放在
public/uploads/2026/08/avatar.jpg，就写asset('uploads/2026/08/avatar.jpg')
Linux 下大小写敏感是高频 404 原因
Windows 开发时用 Images 文件夹，上传到 Linux 服务器后变成 images，但模板里仍写 asset('static/Images/logo.png')，结果就是 404。
立即学习“PHP免费学习笔记（深入）”；
- 统一使用小写命名：文件夹名（
static、images）、文件名（logo.png）、路径参数（asset('static/images/...')）全部小写 - 检查运行时真实路径：用
ls -l public/static/images/确认文件是否存在、大小写是否一致 - 浏览器开发者工具 Network 标签页看具体请求 URL 和响应状态码，比猜更准
CDN 或子目录部署时图片路径会断？
asset() 本身不处理 CDN，但它生成的路径是相对当前域名的。要支持 CDN，得靠配置前缀，而不是改函数调用。
- 在
config/app.php或环境变量里加：'cdn_url' => $_ENV['CDN_URL'] ?? '' - 自定义一个辅助函数：
function cdn_asset($path) { return config('cdn_url') . asset($path); } - 子目录部署（如
/myapp/）无需额外操作 ——asset()会自动识别并补上前缀，前提是 Web 服务器已正确配置且入口正常
最容易被忽略的是：伪静态规则生效 ≠ 图片能加载。哪怕 /index/index 能打开，/static/images/logo.png 仍可能 404 —— 因为它是静态请求，不走 PHP 路由，只依赖 Web 服务器配置和文件物理路径是否对得上。
