宝塔部署ThinkPHP伪静态错误解决方法

本文深入解析了宝塔面板部署 ThinkPHP 6 时伪静态配置频繁报 404 的根本原因——并非规则写错，而是宝塔内置的 ThinkPHP 预设规则专为 TP5 设计，与 TP6 默认采用的 pathinfo 模式、public 入口结构及 URL 处理机制严重不兼容；文章直击三大痛点：目录层级错位（站点根目录未对齐 public）、Nginx rewrite 规则未适配 pathinfo 路径传递、PHP-FPM 未正确解析 PATH_INFO，并给出经实战验证的精准 Nginx 规则、关键 fastcgi 参数配置、分层排查方法（curl 测试、错误日志分析、临时日志追踪）及易被忽视的防火墙拦截陷阱，帮你彻底摆脱“选了预设却依然 404”的无效操作，真正实现 TP6 在宝塔上的开箱即用。

宝塔面板里 ThinkPHP 伪静态规则为什么总 404？

直接原因是宝塔内置的 ThinkPHP 预设规则默认适配的是 ThinkPHP 5.0–5.1 的 URL 模式（index.php?s=/home/index/index），而 TP6 默认启用 pathinfo 且关闭 index.php 入口，同时路由可能已开启强制小写或去除后缀——预设规则没匹配上真实请求路径，Nginx 就找不到对应的 PHP 脚本，直接返回 404。

• 检查你项目根目录是否存在 public/ 子目录：TP6 默认入口在 public/index.php，但宝塔站点根目录通常指向 /www/wwwroot/your-site/（即 TP6 的上层），这会导致 rewrite 规则里的 index.php 路径错位
• 确认是否启用了 url_html_suffix 或自定义路由后缀（如 .html），预设规则不处理带后缀的 pathinfo
• TP6 的 app_host 或 url_domain_root 配置会影响生成 URL，但不会影响伪静态匹配——别在这儿调配置找原因

正确的伪静态内容应该长什么样？

不要点“选择 ThinkPHP 预设”，手动清空并粘贴以下 Nginx 规则（适用于 TP6 + public/ 入口结构）：

if (!-e $request_filename) {
    rewrite ^/public/(.*)$ /public/index.php/$1 last;
    rewrite ^/(.*)$ /public/index.php/$1 last;
}

说明：
第一行防止直接访问 /public/xxx 路径被绕过入口；第二行把所有非静态文件请求统一交给 /public/index.php 处理。注意这里用的是 /$1（pathinfo 模式），不是 ?s=/$1（兼容模式）。

• 若你把 public/ 提升为站点根目录（推荐），则规则简化为：

  if (!-e $request_filename) { rewrite ^(.*)$ /index.php/$1 last; }

• Apache 用户请改用 .htaccess 中的 RewriteCond %{REQUEST_FILENAME} !-f + RewriteCond %{REQUEST_FILENAME} !-d 组合，别套用 Nginx 规则
• 宝塔「网站」→「设置」→「伪静态」里粘贴后，必须点「保存」再点「重载配置」，只保存不重载等于没改

rewrite 后 PHP 里 $_SERVER['PATH_INFO'] 为空怎么办？

这是 Nginx + PHP-FPM 常见的 CGI 参数传递问题：rewrite 成功了，但 PHP 没收到 pathinfo。根本原因是 fastcgi_param SCRIPT_FILENAME 和 fastcgi_param PATH_INFO 没正确分离。

• 进宝塔 →「网站」→「设置」→「配置文件」，找到类似 include enable-php.conf; 的行，在它前面插入：

  fastcgi_split_path_info ^(.+?\.php)(/.*)$;

• 确保已有这三行（顺序不能错）：

  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  fastcgi_param PATH_INFO $fastcgi_path_info;
  fastcgi_param SCRIPT_NAME $fastcgi_script_name;

• TP6 的 config/app.php 中 'url_convert' => true 必须为 true，否则框架不解析 PATH_INFO

验证和排查时最该看哪几个地方？

别只刷首页看是否 404，要分层验证：

• curl 测试原始路由：curl -I http://yoursite.com/index.php/home/index/index —— 如果这个 200，说明 PHP 和入口正常，问题纯属 rewrite 层
• 查看 Nginx 错误日志：/www/wwwlogs/yoursite.error.log，搜索 rewrite or internal redirection cycle 表示重写死循环，no input file specified 表示 SCRIPT_FILENAME 路径错误
• 在 public/index.php 开头加一行：file_put_contents('/tmp/pathinfo.log', print_r($_SERVER, 1), FILE_APPEND);，访问任意 URL 后看日志里 PATH_INFO 和 SCRIPT_NAME 的值是否符合预期
• 宝塔「安全」→「防火墙」里关掉临时防护，某些版本会拦截含 index.php/ 的请求并返回 403

真正卡住的往往不是规则本身，而是 public 目录层级、PATH_INFO 传递、以及你以为“选了预设就完事了”的那个错觉。

理论要掌握，实操不能落！以上关于《宝塔部署ThinkPHP伪静态错误解决方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！