静态资源不显示大概率是web服务器根目录未指向public、app_url配置错误或路径拼写错误；需检查nginx/apache的root/documentroot设置、.env中app_url是否完整正确、视图中asset()参数是否含多余public前缀，并确认文件权限与浏览器缓存。
静态资源不显示，大概率不是 Laravel 代码问题，而是 Web 服务器没把 public 目录当根目录，或者路径拼错了——直接查这三处，90% 能当场解决。
确认 Web 服务器根目录是否指向 public
这是最常被忽略的前提。Laravel 的入口文件 index.php 必须放在 Web 可访问的根路径下，而它就在 public/ 目录里。
- Nginx 配置中
root指令必须指向你的项目public目录，例如：root /var/www/myapp/public;，不是项目根目录 - Apache 的
DocumentRoot同理，应设为/var/www/myapp/public - 共享主机（如 cPanel）常见错误：把整个 Laravel 项目上传到
public_html，但没把public里的内容挪进去，或没改public_html的实际指向 - 用
php artisan serve跑通 ≠ 线上能跑通——它绕过了 Web 服务器配置，不具参考性
asset() 函数生成的 URL 是否匹配真实访问路径
asset() 会拼接 APP_URL 和相对路径，如果 APP_URL 配错，所有 CSS/JS/图片链接都会 404。
Laravel 13.2.0
下载
Laravel 13.2.0 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
- 检查
.env中APP_URL是否带协议和完整域名，例如：APP_URL=https://example.com（末尾不要加/） - 确保视图中只传相对路径，比如
asset('css/app.css')→ 对应public/css/app.css；若写成asset('public/css/app.css')就会变成双public，404 - 数据库里存的图片名（如
photo.jpg），在模板里必须用asset("upload/portfolio_images/{$item->image}")，不能拼public/前缀 - 清掉浏览器缓存再测试，有时旧的 404 响应也被缓存了
Nginx/Apache 是否拦截了静态文件或返回了错误头
静态资源由 Web 服务器直发，PHP 中间件完全不生效。跨域、403、404 都得看服务器日志和响应头。
- 打开浏览器 DevTools → Network → 找一个 .css 或 .jpg 请求 → 看 Status 和 Response Headers。如果是 403，大概率是目录权限不对（
public/upload目录需对www-data或nginx用户可读） - CORS 报错（
Access-Control-Allow-Origin missing）？说明前端从其他域名加载了你的 CSS —— 这时要改 Nginx 的add_header 'Access-Control-Allow-Origin' 'https://your-frontend.com' always;，不是 Laravel 配置 - Nginx 配置里如果写了
location ~ \.php$ { ... }但漏了try_files $uri =404;，可能导致 .js/.css 请求被错误地转给 PHP-FPM，返回 500 或空白 - 用
curl -I https://example.com/css/app.css直接看 HTTP 头，比浏览器更干净
真正卡住的地方，往往在 APP_URL 和 Web 服务器 root 路径的微小偏差，或者上传目录权限没放开到 Web 用户。别急着重装包，先盯死这两点。
