ThinkPHP报500却无提示，主因是错误被拦截或日志未落盘：需先确认APP_DEBUG=true、runtime/log/可写、display_errors=On、error_reporting≥E_ALL，并开启LOG_RECORD=true，否则异常不显示也不记录。
ThinkPHP 报 500 错误却看不到任何提示，不是框架“坏了”，而是错误被层层拦截或压根没写进日志——先确认 APP_DEBUG 是否为 true，再检查 runtime/log/ 目录是否可写，否则连堆栈都留不下。
APP_DEBUG=true 但页面还是空白？检查 PHP 层错误开关是否生效
框架的 APP_DEBUG 只控制 ThinkPHP 自己的异常渲染逻辑，底层 PHP 的错误报告仍由 display_errors 和 error_reporting 决定。很多部署环境（尤其是宝塔、LNMP 一键包）默认关闭了这两项。
- 运行
php -i | grep -E "display_errors|error_reporting"，确认display_errors是On，且error_reporting不低于E_ALL - 若用 Nginx + PHP-FPM，
display_errors必须在 PHP-FPM 池配置中设为php_flag[display_errors] = on，仅改php.ini可能不生效 - 临时在
public/index.php最开头加两行：ini_set('display_errors', '1'); error_reporting(E_ALL);，绕过所有中间层直接暴露原始错误
日志写不进 runtime/log/？重点查目录权限和 LOG_RECORD 开关
ThinkPHP 默认不会自动记录所有异常，LOG_RECORD 必须显式开启，否则哪怕 APP_DEBUG=false，错误也只进 500 页面，不落盘。
- 在
config/app.php中确保有：'log' => ['record' => true, 'level' => ['error', 'sql'], 'type' => 'File'] - 执行
ls -ld runtime/ runtime/log/，确认 Web 进程用户（如www-data、nginx或www）对这两个目录有w和x权限 - 运行
chown -R www-data:www-data runtime/（根据实际用户调整），再chmod -R 755 runtime/ - 若用 Swoole 或多进程模式，
LOG_PATH可能被重定向到其他路径，需检查是否指向了不存在或不可写的目录
数据库连不上却只报 500？PDO 异常被静默吞掉了
当 database.php 配置错误（密码错、host 不通、端口被封），PDOException 在 APP_DEBUG=false 下会被框架捕获并转成通用 500 页面，不输出任何线索。
立即学习“PHP免费学习笔记（深入）”；
- 命令行直连验证：
php -r "new PDO('mysql:host=127.0.0.1;dbname=test', 'root', '123456'); echo 'OK';"，失败则立刻暴露具体原因 - 检查 MySQL 是否启用了
skip-networking，或云服务器安全组是否放行了 3306 端口 - 临时在
app/common.php开头加ini_set('display_errors','1'); error_reporting(E_ALL);，强制把 PDO 错误打到页面上 - Apache/Nginx 若未传递
PATH_INFO或REQUEST_URI，框架路由初始化阶段就可能崩溃，且不触发日志——检查服务器伪静态规则是否完整
Windows 下中文路径或计算机名引发 Malformed UTF-8？别猜，直接验证
ThinkPHP 底层在 think\response\Json.php 对服务器信息做 JSON 编码时，若系统名、项目路径含中文（尤其 Windows），会因 GBK 字符无法被 UTF-8 编码而抛出 Malformed UTF-8 characters，且该错误常被静默忽略。
- 快速验证：把项目移到纯英文路径（如
D:/tp6/），或临时将 Windows 计算机名改为英文，再刷新页面 - 若错误消失，问题就锁定在编码层面；不要试图改框架源码，应统一项目路径与系统环境为 UTF-8 友好环境
- 注意：此问题在 Linux 服务器上极少出现，但 Docker 容器内若 locale 未设为
en_US.UTF-8，也可能复现
最易被忽略的一点：500 错误可能根本不是 PHP 层的问题——用 curl -v 看响应头里的 Server 和 Content-Type，如果是 text/html 且无 X-Powered-By，大概率是 Nginx/Apache 自己返回的通用错误页，得去翻 Web 服务器日志，而不是 PHP 日志。
