ThinkPHP项目部署后访问出现空白页面怎么排查-ThinkPHP-PHP中文网

空白页主因是错误被隐藏，需开启php错误显示：在public/index.php最开头启用display_errors并设error_reporting(e_all)。

thinkphp项目部署后访问出现空白页面怎么排查

空白页不是代码没输出，而是错误被吞了、路径错了、权限卡了，或者重写规则根本没生效——先暴露报错，再逐层验证。

ThinkPHP 默认关掉 display_errors，白屏其实是“有错不吭声”。光改 APP_DEBUG => true 不够，得让 PHP 本身把错误打到页面上：

在 public/index.php 最开头（<?php 后第一行）、任何 require 前插入：error_reporting(E_ALL); ini_set('display_errors', '1');
刷新页面：如果出现红色 Fatal error: Class 'think\App' not found，说明已暴露问题；如果还是空白，说明错误发生在更早阶段（比如 vendor/autoload.php 加载失败或 PHP 版本不兼容）
上线前必须删掉这两行——生产环境不能暴露错误信息

ThinkPHP 6+ 强制要求 Web 服务器的根目录落在 public/ 下，设错会导致自动加载器路径崩坏，直接静默失败：

PHP

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

下载

宝塔用户：站点 → 设置 → 网站目录 → 运行目录选 /public（用下拉菜单选，别手动输）
Nginx 用户：检查 server 块里的 root 指令，必须是 root /path/to/your-project/public;（末尾分号不能漏）
Apache 用户：确保 DocumentRoot 指向 public 目录，且 .htaccess 文件存在并生效
快速验证：访问 http://你的域名/public/index.php，能打开说明入口路径没问题

框架启动时要生成日志、缓存、模板编译文件，全靠 runtime/ 目录。给整个项目递归赋权不仅无效，还可能触发安全警告：

老式 if (!-e $request_filename) { rewrite ... } 在 Windows 和部分 Nginx 版本下极易导致 $_SERVER['PATH_INFO'] 为空，ThinkPHP 8.0 依赖它解析路由，一空就静默失败：

删除所有 if 重写块
在 location / { } 里写标准规则：try_files $uri $uri/ /index.php?$query_string;（漏掉 $uri/ 会导致 /admin/ 这类带斜杠路径直接 404）
快速验证：访问 http://你的域名/index.php/test，能通说明路由正常，问题纯属重写配置

真正卡住的地方往往不是报错内容本身，而是错误根本没显示出来——display_errors 没真开、root 指向错了一级、runtime 属主和 PHP 进程用户不一致、或者 try_files 少写了 $uri/。这四点顺序查下来，基本就见着底了。