ThinkPHP页面空白主因是PHP错误被屏蔽、Web根目录未设为public、权限配置不当或PHP-FPM异常；应开启display_errors、将根目录指向public、仅给runtime赋写权限、检查扩展加载及日志。
宝塔面板里ThinkPHP页面空白，先确认PHP错误是否被屏蔽
ThinkPHP 页面空白，90% 是 PHP 报错被静默吞掉，而不是代码真没输出。宝塔默认关闭 display_errors，且 error_reporting 常设为 E_ALL & ~E_NOTICE 或更低，导致致命错误（如语法错、类找不到）直接白屏，连 500 都不返回。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 登录宝塔 → 网站 → 对应站点 → 设置 → PHP 版本 → 点击右侧「配置文件」→ 找到
display_errors = Off，改为display_errors = On - 同时确认
error_reporting = E_ALL（不是E_ALL & ~E_DEPRECATED这类过滤项） - 改完必须点「保存」，再「重启 PHP」服务（仅重载配置不够，部分报错需进程级生效）
- 刷新页面，如果出现红色错误信息（比如
Fatal error: Class 'think\App' not found），说明已成功暴露问题
ThinkPHP 6+ 在宝塔下白屏，大概率是入口文件未正确指向 public 目录
ThinkPHP 6 默认要求 Web 根目录为 public/，但宝塔新建站点时默认把根目录设在项目根（即含 app/、config/、public/ 的那层），导致 index.php 被直接执行，而自动加载器路径错乱，vendor/autoload.php 找不到或 think 命名空间注册失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 宝塔 → 网站 → 对应站点 → 设置 → 根目录 → 改为项目内的
/www/wwwroot/your-site/public（注意不是项目根） - 确保
public/index.php存在且可读（权限至少 644） - 检查
public/.htaccess（Apache）或宝塔 Nginx 配置中是否误删了 ThinkPHP 的重写规则；Nginx 用户重点看「伪静态」是否选了thinkphp，而不是留空或选laravel5 - 若用 PHP 内置服务器调试（
php think run），它不经过宝塔 Web 服务，结果不能代表线上行为
宝塔里 chmod -R 755 不解决 ThinkPHP 白屏，反而可能引发安全警告
盲目给整个项目递归 755，对 ThinkPHP 反而危险：日志和缓存目录（runtime/）需要写入权限，但 app/、config/、vendor/ 绝对不该被 Web 进程写入。宝塔面板的「权限设置」页里点「一键修复」也会误改关键目录权限。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 只给
runtime/目录（及其子目录）赋予写权限：chmod -R 755 runtime→ 实际更稳妥是chmod -R 775 runtime，并确认其所属用户组与 PHP 运行用户一致（通常是www） - 检查
runtime/所有者：chown -R www:www runtime（宝塔 PHP 进程一般以www用户运行） - 禁止给
public/下的index.php设 777 —— 宝塔会标红警告，且可能触发安全模块拦截 - 如果用宝塔「文件」管理器手动改权限，务必关掉「递归修改」开关，逐个点选
runtime目录操作
开启 display_errors 后仍白屏？查 PHP-FPM 的 slow log 和 access log
有些错误不会进 PHP 错误日志（比如 FPM 子进程崩溃、超时、内存耗尽），但会在 Nginx 的 error.log 或 PHP-FPM 的 slow.log 里留下线索。例如 recv() failed (104: Connection reset by peer) 往往意味着 PHP 进程异常退出。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 宝塔 → 网站 → 对应站点 → 日志 → 查看「错误日志」，搜索关键词
PHP message、FPM、segmentation fault - 宝塔 → 软件商店 → PHP → 对应版本 → 设置 → 配置修改 → 检查
request_slowlog_timeout = 1s是否开启，并确认slowlog = /www/wwwlogs/php-slow.log路径存在且可写 - 临时提高 PHP 内存限制：
memory_limit = 256M（ThinkPHP 6+ 加载较多组件时容易触顶 128M 默认值） - 如果用了 Redis 或 PDO 连接数据库，白屏前无任何提示，优先检查
extension=redis.so是否在 php.ini 中启用，以及pdo_mysql是否已加载（php -m | grep pdo）
真正卡住的地方，往往不是 ThinkPHP 自身，而是宝塔把 PHP 配置、Web 根目录、Linux 权限、FPM 进程模型这四层拧在一起，改一处就可能牵出另一处报错。每次只动一个变量，改完立刻验证，比同时调三个配置更可靠。
