ThinkPHP静态资源404主因是Web服务器未正确暴露public目录：Apache需正确配置Alias（路径以/开头、目标为绝对路径且末尾带/），Nginx需用location ^~ /static/ + root指向public父目录；CDN回源须设/public前缀或URL重写；asset()函数不加public前缀，依赖服务器根目录为public。
Apache下ThinkPHP静态资源404：Alias路径没配对
ThinkPHP部署后CSS、JS、图片全404，大概率是Web服务器没把public目录正确暴露，而Alias配置写错了路径或漏了尾部斜杠。
常见错误现象：http://example.com/static/css/app.css 返回404，但直接访问http://example.com/public/static/css/app.css能打开；说明请求没被重写到public，或Alias指向了错误位置。
- Alias路径必须以
/开头，且目标路径必须是绝对路径（如/var/www/myapp/public/static），不能用相对路径 - Alias末尾的
/不能省——Alias /static /var/www/myapp/public/static/✅，Alias /static /var/www/myapp/public/static❌（后者会导致子路径匹配失败） - 确保
public目录权限可读，且Apache已启用mod_alias模块（Debian系执行a2enmod alias）
Nginx中ThinkPHP静态资源404：root和location优先级搞反了
Nginx里root写在server块，却没在location /static里覆盖，结果所有静态请求仍走PHP入口，自然404。
使用场景：ThinkPHP项目根目录为/var/www/myapp，静态资源实际在/var/www/myapp/public/static。
立即学习“PHP免费学习笔记（深入）”；
- 必须为静态路径单独写
location ^~ /static/，并在其中用root指向public父目录（不是public/static） - 示例配置片段：
location ^~ /static/ { root /var/www/myapp/public; expires 1y; add_header Cache-Control "public, immutable"; } - 别用
alias配/static/——它会拼接路径，容易多出一层public导致404；root更直白可控
CDN回源配置错位：静态资源URL没带public前缀
本地能加载，CDN上全404，通常是CDN回源地址填成了站点根目录（如https://example.com），而没指向public子目录，导致CDN拉取时路径错位。
参数差异：CDN控制台里的“回源Host”和“回源路径”是两回事。前者决定HTTP Host头，后者决定URL前缀是否补/public。
- 回源Host应设为真实服务器域名（如
origin.example.com），不是example.com本身（避免循环） - 如果站点URL是
https://example.com/static/xxx.css，但服务器只认/public/static/xxx.css，就得在CDN设置“URL重写”或“回源路径前缀”为/public - 部分CDN（如Cloudflare Pages、又拍云）支持自定义回源规则，优先选“保留原始URI，仅修改Host”，再配合服务器端Alias/Location处理
ThinkPHP内置asset()函数生成路径失效
asset('css/app.css') 输出/css/app.css而非/public/css/app.css，说明应用没运行在public子目录下，或者APP_URL和ASSET_URL没对齐。
性能影响：路径错会导致浏览器反复请求404，触发大量无效HTTP连接，拖慢首屏渲染。
- 检查
.env中APP_URL是否包含public（不该含），例如APP_URL=https://example.com✅，APP_URL=https://example.com/public❌ - 若需CDN加速静态资源，不要改
APP_URL，而是单独设ASSET_URL=https://cdn.example.com，并确保CDN回源能正确映射 -
asset()默认不加public前缀——ThinkPHP约定Web服务器已将public设为文档根，函数只负责拼接相对路径
最容易被忽略的是：CDN开启HTTPS后，回源若仍用HTTP，部分CDN（如腾讯云CDN）会静默丢弃非200响应，导致404不报错但资源不加载。务必确认回源协议和状态码透传设置。
