PHP ThinkPHP 报错页面空白怎么排查-php教程-PHP中文网

先开启php错误显示再排查：在public/index.php首行加ini_set('display_errors','1')，确保web服务器根目录指向public/，runtime目录需775权限且属主为www，伪静态规则必须正确配置。

php thinkphp 报错页面空白怎么排查

页面空白不是没报错，是报错被吞了——先让错误浮出来，再顺着堆栈往下查。

public/index.php开头加两行就暴露致命错误

ThinkPHP 的 APP_DEBUG 配置只管框架层异常，PHP 底层致命错误（比如语法错、扩展没装、vendor/autoload.php 加载失败）根本进不到框架里，ini_set('display_errors', '1') 必须写在 public/index.php 第一行 PHP 标签后、任何 require 或 include 之前。

加完立刻刷新，如果出现红色 Fatal error: Class 'think\App' not found，说明问题出在自动加载或入口路径
如果还是空白，说明错误发生在更早阶段：可能是 php.ini 级别 display_errors = Off 被强制关闭，或 Web 服务器（如 Nginx）通过 fastcgi_param PHP_VALUE "display_errors=Off" 覆盖了脚本设置
别在 CLI 下测试：运行 php public/index.php 看不到 HTML 错误堆栈，且 CLI 和 Web 环境的 SAPI、配置完全隔离

宝塔/Nginx/Apache 的根目录必须指向 public/

ThinkPHP 6+ 强制要求 Web 服务器的 DocumentRoot 落在 public/ 目录下。设成项目根目录（含 app/、config/、vendor/ 那层），会导致 vendor/autoload.php 路径计算错误，命名空间注册失败，直接触发 Fatal error 且不报错。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

宝塔用户：网站 → 设置 → 「根目录」必须选 /www/wwwroot/your-site/public（下拉选择，不要手动输）
Nginx 用户：检查 server 块中 root 指令是否为 root /path/to/your-project/public;（末尾分号不能漏）
Apache 用户：确认 DocumentRoot 指向 public，且 .htaccess 文件存在并启用 mod_rewrite
验证方式：浏览器访问 http://yoursite.com/public/index.php，若返回 404 或 500，说明 Web 服务器根本没把请求交给 PHP 处理

runtime 目录权限只给它自己，别碰其他目录

runtime/ 是 ThinkPHP 运行时唯一需要写的目录，用来存日志、缓存、模板编译文件。给整个项目递归 chmod -R 755 不但无效，还会导致安全警告，甚至让框架拒绝启动。

只对 runtime 及其子目录赋权：chmod -R 775 runtime
确保属主与 PHP 进程用户一致：宝塔默认是 www，执行 chown -R www:www runtime
检查 runtime/log/ 下是否有按日期生成的日志文件（如 202608/31.log），没有说明不可写，或 config/app.php 中 'log' => ['type' => 'test'] 被设成了哑巴模式
刚部署建议删掉整个 runtime 目录，让框架重新生成干净缓存

伪静态规则失效会导致首页通、其他路由 404 或空白

首页能打开但点菜单就 404，基本是 URL 重写没生效。ThinkPHP 默认依赖重写把所有请求转发给 public/index.php 处理。

Apache：确认项目根目录下有 .htaccess，且宝塔面板中「伪静态」已选「ThinkPHP」模板
Nginx：server 块中必须包含 try_files $uri $uri/ /index.php?$query_string;，漏掉 $uri/ 会导致 /admin/ 这类带斜杠路径直接 404
快速验证：访问 http://yoursite.com/index.php?s=/index/index，能通说明路由逻辑正常，问题纯属重写配置
别信 php think run：它走 CLI 模式，不经过 Web 服务器和重写规则，结果毫无参考价值