ThinkPHP 8.0 报 500 错误主因是错误被层层静默拦截：需先在public/index.php顶部加ini_set('display_errors','1')和error_reporting(E_ALL)，再查runtime/log权限及LOG_RECORD配置，最后直连PDO或dump(env('DB_HOST'))定位数据库连接或.env加载失效问题。
ThinkPHP 8.0 报 500 错误，页面空白、日志空荡、堆栈隐身——这不是代码写崩了，而是错误在 PHP 层就被静默吞掉、框架层被拦截、日志层因权限或配置失效而彻底失声；必须从入口文件第一行开始拆解，绕过所有中间层伪装，直取原始报错信息。
强制暴露原始错误：从 PHP 层打开“手电筒”
这一步操作起来很简单，直接在 public/index.php 最顶部 插入两行，且必须放在 require __DIR__ . '/../vendor/autoload.php'; 之前。
第一行写：ini_set('display_errors', '1');
第二行写：error_reporting(E_ALL);
立即学习“PHP免费学习笔记（深入）”；
注意：如果服务器用的是 Nginx + PHP-FPM，默认 fastcgi_intercept_errors on; 会把所有 500 响应替换成 Nginx 自己的错误页，导致你加了上面两行也看不到任何 PHP 错误——此时必须进 Nginx 配置，把这一行注释掉或改为 off，然后 reload Nginx。
确认日志是否真在写：别信 runtime/log/ 是否存在
runtime/log/ 目录下空空如也？不代表没错误，只代表日志根本没落盘。ThinkPHP 8.0 默认只在 LOG_RECORD = true 且目录可写 时才记录异常堆栈。
第一步：检查 config/app.php 中日志配置是否显式启用：
确保 'record' => true 和 'level' => ['error', 'sql'] 已设置，不要依赖默认值。
第二步：执行命令验证权限：ls -ld runtime/ runtime/log/
若显示权限不含 w（如 dr-xr-xr-x），说明 Web 进程用户（如 www-data 或 nginx）无写权。
第三步：修复权限（Ubuntu/Debian）：chown -R www-data:www-data runtime/
CentOS 系统则用：chown -R nginx:nginx runtime/
特别提醒：若项目运行在 Swoole 或 RoadRunner 下，LOG_PATH 可能被重定向至 /tmp/think-log，需单独检查该路径是否存在且可写。
揪出数据库连接失败的真实原因
TP8.0 在数据库连不上时，会把 PDOException 转成通用 500 页面，原始 message 全丢——关键线索全藏在 PDO::getMessage() 里，不直连就永远看不到。
方法一：临时在 app/common.php 开头加：ini_set('display_errors', '1'); error_reporting(E_ALL);
刷新页面，看是否爆出类似 SQLSTATE[HY000] [2002] Connection refused 的真实错误。
方法二：命令行直连验证（替换 host/db/user/pass）：php -r "new PDO('mysql:host=127.0.0.1;dbname=test', 'root', '123456'); echo 'OK';"
若报错，说明不是 TP 配置问题，而是 MySQL 服务未启、端口被封、密码错误或 skip-networking 开启。
方法三：检查 .env 文件是否加载失效：
在任意控制器中 dump(env('DB_HOST'))，若返回 null，说明环境变量未加载成功，要检查 vendor/topthink/framework/src/helper.php 中 env() 函数调用链是否被覆盖，或 .env 文件编码是否为 UTF-8 无 BOM。
排查伪静态引发的静默崩溃
index.php 单独访问正常，一开伪静态就 500，大概率是框架初始化阶段因路径解析失败而提前终止——此时连日志系统都来不及启动，自然无痕无迹。
先做快速验证：在 public/index.php 第一行加 print_r($_SERVER); die();，然后分别访问 /index.php/test 和伪静态路径如 /test，对比 REQUEST_URI、PATH_INFO、SCRIPT_NAME 的值。若后者缺失 PATH_INFO 或出现双斜杠、中文乱码、CDN 截断，则说明服务器未正确传递路径变量。
Nginx 用户必须检查 fastcgi_param 配置：
确保有这一行：fastcgi_param PATH_INFO $path_info;
没有就加上，reload Nginx。
Apache 用户请确认已启用 mod_rewrite，并在 .htaccess 中仅保留最简规则：
RewriteEngine On<br>RewriteCond %{REQUEST_FILENAME} !-f<br>RewriteCond %{REQUEST_FILENAME} !-d<br>RewriteRule ^(.*)$ index.php/$1 [L]LiteSpeed 用户请把
[L] 换成 [END] 或直接删掉。
验证异常处理器是否真正生效
ThinkPHP 8.0 的异常处理不再读 config/app.php 的 exception_handle，也不认 config/exception.php——所有旧写法都会静默失效，退回到框架默认兜底行为，结果就是 500 页面不带堆栈、日志里空空如也。
正确做法只有唯一路径：
① 确保 app/exception/Handler.php 类实现 think\contract\ExceptionHandlerInterface；
② 在 app/provider.php 中注册：
return [<br> 'think\exception\Handle' => app\exception\Handler::class,<br>];
③ Handler 类中
render() 方法签名必须含 Request $request 参数，不可省略或用 app('request') 替代；④
report() 方法内必须显式调用 parent::report($e)，否则日志链路断裂，Sentry、Log channel、框架统计全部失效。
若已按上述步骤配置但依然无日志，立刻检查 app/provider.php 是否被其他 require 或 autoload 干扰——该文件必须由框架自动加载，不能手动 include。
