ThinkPHP 6.0 动静未分离是因 Nginx 全局 try_files 兜底至 /index.php,导致静态资源被 PHP 处理;应通过路径前缀、文件后缀或 @php 分离方式配置 location 规则,并确保静态文件物理存在且 Nginx 配置顺序正确。

ThinkPHP 6.0 默认使用 Nginx 的 try_files $uri $uri/ /index.php?$query_string 路由兜底规则,导致所有未命中真实文件的请求(包括 /static/css/app.css)都会被错误转发给 PHP-FPM 处理,白白占用进程、增加磁盘 I/O,且无法启用 Nginx 原生缓存与 gzip 压缩。
确认当前动静混流问题
第一步:在浏览器开发者工具 Network 标签页中刷新页面,筛选 XHR 或 Doc 类型请求,观察所有 .js、.css、.png 等静态资源响应头中的 X-Powered-By 字段——若存在且值为 PHP/8.1.27(或类似),说明该请求已被 PHP 解析,即动静未分离。
第二步:SSH 登录服务器,执行 sudo nginx -T 2>/dev/null | grep -A5 'location.*\.php\|try_files' | head -n10,检查是否全局启用兜底到 /index.php 的配置。若输出中含 try_files $uri $uri/ /index.php?$query_string 且未被更精确的静态 location 拦截,问题已定位。
方法一:按路径前缀分离(推荐用于 ThinkPHP 标准部署)
编辑站点 Nginx 配置文件(如 /etc/nginx/conf.d/your-site.conf),在 server 块内、location / 之前插入以下配置:
立即学习“PHP免费学习笔记(深入)”;
location ^~ /static/ {<br> alias /var/www/your-project/public/static/;<br> expires 1y;<br> add_header Cache-Control "public, immutable";<br>}
location ^~ /uploads/ {<br> alias /var/www/your-project/public/uploads/;<br> expires 7d;<br>}
【注意】alias 末尾斜杠必须与 location 路径结尾一致:location 是 /static/,alias 就必须是 /.../static/;若写成 /var/www/.../static(缺末尾斜杠),Nginx 会拼出 /var/www/.../staticstatic/xxx.css 导致 404。
保存后执行 sudo nginx -t && sudo systemctl reload nginx。
方法二:按文件后缀分离(适用于多目录混合静态资源)
在 server 块顶部添加如下正则匹配块:
location ~* \.(?:css|js|png|jpg|jpeg|gif|ico|svg|woff2?|ttf|eot|pdf)$ {<br> add_header Cache-Control "public, max-age=31536000, immutable";<br> expires 1y;<br> try_files $uri =404;<br>}
这行 try_files $uri =404 是关键:它强制 Nginx 只检查真实文件是否存在,不兜底到 PHP;若文件不存在,直接返回 404,避免误交由 index.php 处理。
务必确保该 location 块位于所有 location ~ \.php$ 和兜底 location / 规则之前——Nginx 匹配顺序优先级:精确匹配 > 前缀匹配(^~) > 正则匹配(~ 或 ~*)> 普通前缀匹配。放错位置会导致正则失效。
方法三:彻底关闭兜底,仅放行明确路径
找到原配置中类似 location / { try_files $uri $uri/ /index.php?$query_string; } 的区块,将其替换为:
location / {<br> try_files $uri $uri/ @php;<br>}
location @php {<br> fastcgi_pass unix:/run/php/php8.1-fpm.sock;<br> fastcgi_index index.php;<br> fastcgi_param SCRIPT_FILENAME $document_root/index.php;<br> include fastcgi_params;<br>}
这个改动将兜底行为从“所有未命中路径”收缩为“仅当 $uri 和 $uri/ 都不存在时才走 @php”,静态文件只要物理存在就绝不会进 PHP。但需同步检查 ThinkPHP 的 public 目录下是否真实存在所有引用的静态文件——例如 public/static/css/app.css 必须存在,否则会 404。
执行 sudo nginx -t && sudo systemctl reload nginx 后,立即用浏览器访问一个 CSS 文件 URL(如 https://yoursite.com/static/css/app.css),查看响应头:若无 X-Powered-By、有 Cache-Control 且状态码为 200,则动静分离生效。



















