ThinkPHP静态资源失效的核心原因是Web服务器未正确指向public目录。需确保Nginx root或Apache DocumentRoot设为/public，宝塔中运行目录选/public；模板中用asset()生成路径；Nginx静态路由推荐alias配置；开启强制路由时需通过Route::alias或后缀规则放行静态资源。
ThinkPHP部署后静态资源失效，核心问题不是代码写错了，而是Web服务器没把请求正确落到public目录下的真实文件上。CSS、JS、图片返回404，但/index.php/static/xxx能打开，就说明PHP路由通了，只是静态资源没被直出——这完全是服务器配置层面的问题。
确保Web服务器根目录指向public
这是最常被跳过的前提。ThinkPHP的入口是public/，不是项目根目录（含app、config那些文件夹）。如果Nginx的root或Apache的DocumentRoot设在项目根目录，浏览器访问/static/css/app.css就会去查/var/www/static/css/app.css，而实际路径是/var/www/public/static/css/app.css。
- Nginx：确认每个
server块里root明确指向/path/to/your/app/public - Apache：检查
VirtualHost中DocumentRoot是否为/path/to/your/app/public，且.htaccess就在这个目录下 - 宝塔用户：网站设置 → 「运行目录」必须选
/public，改完要重启服务
模板里别硬写路径，用asset()生成
__STATIC__和__PUBLIC__是编译期常量，不会随域名、子目录或部署环境变化。手写<link href="/static/css/app.css">在二级域名或子目录下大概率出错。
- 正确写法：
<link href="{{ asset('static/css/app.css') }}"> -
asset()参数不带public/前缀，它默认从public开始找文件 - Linux服务器注意大小写：
Static/≠static/，路径错一个字母就是404
Nginx静态资源要配alias或root，别混淆
即使root指向public，如果用了子目录部署（如api.example.com）或需要精准映射，location /static/必须单独处理。
立即学习“PHP免费学习笔记（深入）”；
- 推荐用
alias：location ^~ /static/ { alias /var/www/app/public/static/; }（结尾斜杠不能少） - 用
root也行，但得写成：location ^~ /static/ { root /var/www/app/public; } - 千万别混用：
location /static/ { root /var/www/app; }会导致Nginx去找/var/www/app/static/，而文件其实在public里
开启强制路由时，得放行静态资源
如果设置了'url_route_must' => true，所有请求都必须匹配路由规则，否则直接404。默认情况下，/static/xxx这种路径不会被识别为静态文件，会被当成需要路由的地址拦下来。
- 在
route/app.php顶部加：Route::alias('static', 'static'); - 或者更灵活地按后缀放行：
Route::rule(':path^.*\.(js|css|png|jpg)$', 'static/:path', 'GET', ['ext' => '']); - 加完记得清空
runtime/cache/，否则旧缓存还在生效
