ThinkPHP静态资源404主因是Web服务器根目录未指向public目录，需确保Apache的DocumentRoot或Nginx的root设为/public路径，asset()函数路径不加public前缀，开启强制路由时需放行静态资源扩展名，CDN回源需补/public前缀。
ThinkPHP静态资源访问404，核心问题不是代码写错了，而是请求根本没落到正确的文件路径上。关键要确认：Web服务器是否把 /static/css/app.css 这类请求，准确指向了项目中 public/static/css/app.css 这个物理位置。
Web服务器根目录必须指向public
这是最常见也最容易忽略的一点。ThinkPHP要求Web服务器的文档根（root）直接设为项目 public/ 目录，而不是整个项目根目录（含app、config等文件夹）。
-
Apache：检查虚拟主机配置中的
DocumentRoot，应为类似/var/www/myapp/public；同时确保对应<Directory>块内有AllowOverride All -
Nginx：在
server块中确认root指令值是/var/www/myapp/public，不是/var/www/myapp - 改完后务必重启服务，且注意Linux下路径大小写敏感——
Static和static是两个不同路径
使用asset()函数时路径不能带public前缀
ThinkPHP的 asset() 函数默认以 public/ 为基准目录，传入的路径是相对于 public 的，加 public/ 反而会出错。
- ✅ 正确：
{{ asset('static/css/app.css') }}→ 输出/static/css/app.css - ❌ 错误：
{{ asset('public/static/css/app.css') }}→ 输出/public/static/css/app.css，服务器找不到该路径 - 如果资源放在
public/assets/下，就写asset('assets/js/main.js')
开启强制路由时需手动放行静态资源
当配置 'url_route_must' => true 后，所有请求（包括 /static/xxx）都必须匹配路由规则，否则直接404。此时需在 route/app.php 顶部显式放行：
立即学习“PHP免费学习笔记（深入）”；
- 推荐方式（按扩展名匹配）：
Route::rule(':path^.*\.(js|css|png|jpg|gif|svg|woff2|ttf)$', 'static/:path', 'GET', ['ext' => '']); - 别名方式（结构简单时可用）：
Route::alias('static', 'static');，但必须放在文件最开头 - 改完后清空
runtime/cache/下所有缓存，否则旧规则仍生效
CDN回源路径要补/public前缀
本地能打开、CDN上全404，大概率是CDN拉取资源时，回源地址没带上 /public 前缀。
- 假设站点URL是
https://example.com/static/app.css，而真实文件路径是/public/static/app.css - CDN控制台中，“回源路径”或“URL重写规则”应设置为
/public$1或直接填前缀/public - 不要把“回源Host”设成主站域名（如
example.com），避免循环回源；建议用独立子域如origin.example.com
