宝塔配置ThinkPHP6伪静态404解决方法

宝塔面板下ThinkPHP6项目频繁出现404错误，根源几乎总是伪静态配置失当：Nginx默认无法解析TP6的pathinfo风格URL（如`/index/abc`），必须手动在server块中、`location ~ \.php$`之前精准插入指向`/public/index.php`的rewrite规则，并严格设置运行目录为`/public`、确保`fastcgi_param PATH_INFO`透传——三者缺一不可；盲目套用宝塔内置的TP5伪静态模板、位置放错、用`break`替代`last`、或忽略PATH_INFO配置，都会导致请求看似进入PHP却路由失效，最终框架自身抛出404；验证务必通过`nginx -t`语法检查+`service nginx reload`重启，并用开发者工具确认真实响应状态与内容来源。

宝塔面板下 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：

• 运行目录必须设为 /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。

好了，本文到此结束，带大家了解了《宝塔配置ThinkPHP6伪静态404解决方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！