宝塔面板下ThinkPHP 6出现404,根本原因是伪静态未正确配置:需在server块中location ~ .php$之前添加含/public/index.php的rewrite规则,运行目录设为/public,并确保fastcgi_param PATH_INFO透传。

宝塔面板下 ThinkPHP 6 出现 404,**几乎可以确定是伪静态没配对,或者配了但根本没生效**。不是 TP6 本身有问题,而是 Nginx 默认不识别 index.php/控制器/方法 这种路径格式,必须靠重写规则把请求兜底到 index.php?s=... 才能进路由系统。
为什么直接选“ThinkPHP”预设规则会 404
宝塔内置的“ThinkPHP”伪静态模板默认适配的是 TP5.x 的 URL 风格(index.php?s=/home/index/index),而 TP6 默认启用 pathinfo 模式、入口在 public/index.php、且常关闭 index.php 入口——两者路径结构和参数解析方式完全不兼容。
- 预设规则里写的
rewrite ^(.*)$ /index.php?s=$1 last;假设入口在网站根目录,但你项目实际入口是/public/,结果 rewrite 后访问的是/index.php(404)而非/public/index.php - 规则若放在
location ~ \.php$之后,Nginx 会优先匹配 PHP 文件,if根本不执行 - 部分宝塔版本生成的规则末尾用了
break,导致重写后不再重新匹配 location,/index.php?s=xxx被当成静态文件返回 404
必须手动加 location 块,且位置不能错
进入宝塔 → 网站 → 对应站点 → 配置文件,在 server 块内、location ~ \.php$ **之前** 插入以下内容:
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /public/index.php?s=$1 last;
}
}-
/public/index.php是关键:TP6 默认把入口放在public/子目录,站点根目录必须指向项目根(如/www/wwwroot/myapp),所以 rewrite 目标要带/public/ - 必须插在
location ~ \.php$之前,否则 PHP 匹配优先级更高,if不触发 - 用
last,不是break或redirect;last让 Nginx 重走 location 匹配流程,才能进到 PHP 处理块 - 别信“try_files 替代 if”的说法——在宝塔 + TP6 场景下,
try_files $uri $uri/ /public/index.php?$query_string会导致$_GET['s']为空,路由全挂
还要同步检查两个硬性条件
光配 rewrite 不够,下面两点漏一个,照样 404:
立即学习“PHP免费学习笔记(深入)”;
-
运行目录必须设为
/public:宝塔 → 网站 → 设置 → 网站目录 → 运行目录,下拉选择/public(不是留空,也不是/) -
PHP 配置要透传 PATH_INFO:在站点配置的
location ~ \.php$块内,确认包含这两行:fastcgi_split_path_info ^(.+\.php)(/.+)$;fastcgi_param PATH_INFO $fastcgi_path_info;
如果 fastcgi_param PATH_INFO 被注释或压根没写,TP6 就收不到原始路径,url_route_on 再开也没用。
验证是否真生效,别只看保存成功
改完配置后,必须做两件事:
- 在 SSH 中执行
nginx -t确认语法无误,再执行service nginx reload(不要只点宝塔里的“重启”) - 访问一个明显不存在的路径,比如
https://yoursite.com/test/route/xxx,用浏览器开发者工具看 Network → Response Headers,确认状态码是 200 而非 404,且响应内容来自你的 TP6 控制器,不是 Nginx 默认 404 页面
最容易被忽略的是:rewrite 规则写了,location ~ \.php$ 也配了,但 fastcgi_param PATH_INFO 没跟上,或者运行目录仍指向根目录——这时候所有请求都看似“进了 PHP”,实则 input() 拿不到路由段,框架自己抛出 404。



















