ThinkPHP接口返回500但页面空白，本质是错误被PHP、框架和服务器多层屏蔽；需按四步排查：一、在public/index.php首行插入ini_set('display_errors','1')和error_reporting(E_ALL)强制显示原始错误；二、查php -i确认log_errors=On及error_log路径并验证可写；三、检查runtime目录权限及数据库连接（启用'debug'=>true）；四、排除Nginx/Apache配置问题，可命令行直跑index.php隔离验证。
ThinkPHP接口返回500但页面空白、无错误提示，不是没出错，而是错误被框架和PHP层层屏蔽了。核心思路是：先让错误“浮上来”，再顺日志和权限往下挖根。
第一步：强制显示原始PHP错误
APP_DEBUG=false时，ThinkPHP会吞掉所有异常；即使设为true，若PHP底层未开启报错，依然白屏。最直接有效的方法是在入口文件开头硬启错误输出：
- 打开 public/index.php
- 在第一行
<?php后立即插入两行（确保前面无空格、BOM、echo等任何输出）：ini_set('display_errors', '1');<br>error_reporting(E_ALL); - 刷新接口，看是否出现红色堆栈（如 Class 'think\Db' not found 或 Call to undefined method）
- 若仍无显示，说明错误发生在更早阶段（如 autoload 加载失败），需转向日志
第二步：查准PHP错误日志路径并验证可写
错误不会凭空消失，只是默认写进了服务器日志。但常因路径错误、权限不足或配置关闭而“静默丢失”：
- 执行
php -i | grep -E "log_errors|error_log"，确认 log_errors = On，且 error_log 指向绝对路径（如/var/log/php_errors.log） - 检查该文件是否存在、可写：
ls -l /var/log/php_errors.log；若不存在，创建并授权：sudo touch /var/log/php_errors.log && sudo chown www-data:www-data /var/log/php_errors.log - 手动写入测试：
echo "test" >> /var/log/php_errors.log，再刷新接口，立刻执行tail -n 20 /var/log/php_errors.log查新内容 - 注意：CLI 和 FPM 模式下的 error_log 路径可能不同，优先查 FPM 配置（
php-fpm.conf或 pool 配置里的php_admin_value[error_log]）
第三步：重点检查 runtime 目录权限与数据库连接
ThinkPHP6/5 启动时必须在 runtime/（及 storage/）下写日志、缓存、模板编译文件。权限不对会直接卡在初始化阶段，500且不生成任何日志：
立即学习“PHP免费学习笔记（深入）”；
- 确认 Web 进程用户（如
www-data、nginx或apache）对runtime/及其子目录有读写执行权限：chmod -R 755 runtime/，再设属主：chown -R www-data:www-data runtime/ - 数据库连接失败也常静默500（尤其 MySQL 服务停了、账号密码错、PDO扩展未启用）。可在
config/database.php中临时加：'debug' => true, 'deploy' => 0，再配合上面的display_errors看是否爆出 PDO 连接异常 - 运行
php -m | grep pdo_mysql确认扩展已启用；用php -r "new PDO('mysql:host=127.0.0.1;', 'user', 'pass');"手动测连通性
第四步：排除Web服务器配置干扰
Nginx/Apache 配置不当不会报明确错误，但会让请求根本进不了PHP，最终返回500：
-
Nginx：确认
fastcgi_pass指向正确的 PHP-FPM socket 或端口；检查error_log /var/log/nginx/error.log，搜索 "connect() failed" 或 "upstream prematurely closed" -
Apache：确认启用了
mod_rewrite；项目根目录的.htaccess必须被允许解析（AllowOverride All在虚拟主机配置中已启用） - 临时绕过Web服务器：用
php public/index.php命令行直跑，若成功说明是Nginx/Apache层问题；若仍500，则聚焦PHP和代码
