ThinkPHP接口返回500但前端无错误详情，主因是错误被静默捕获或未输出：需确保APP_DEBUG=true、display_errors=On、error_reporting=E_ALL，启用LOG_RECORD=true并检查runtime/log写权限，排查中文路径导致的UTF-8编码错误及Web服务器PATH_INFO传递缺失。
ThinkPHP接口返回500，但前端看不到错误详情？不是框架“没报错”，而是错误被吞了、没露出来、或根本没写进日志——得一层层拆开看。
为什么开启APP_DEBUG后还是500空白页
ThinkPHP在 APP_DEBUG = true 时，会主动检查 PHP 环境是否支持显示错误。如果 display_errors 是 Off 或 error_reporting 被设为 0，框架就拒绝渲染错误页面，直接抛出 500 —— 这是它的兜底保护机制，不是 bug。
实操建议：
- 运行
php -i | grep -E "display_errors|error_reporting"，确认输出中display_errors值为On，error_reporting数值不低于32767（即E_ALL） - 临时在入口文件
public/index.php顶部加两行：ini_set('display_errors', '1'); error_reporting(E_ALL);，绕过框架检查 - Windows 下项目路径含中文、或服务器主机名是中文，可能触发
Malformed UTF-8 characters错误，该错误在 JSON 响应阶段被静默捕获，导致空白 500 —— 把项目移到纯英文路径下试试
runtime/log 为空，错误日志根本没生成
日志写不进去，常见原因不是配置错，而是权限或开关关着。ThinkPHP 默认只在 LOG_RECORD => true 时才记录异常堆栈，而这个选项在生产配置里常被默认关闭。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 检查
config/app.php中的log配置，确保显式启用：'record' => true，且'level' => ['error', 'sql'] - 执行
ls -ld runtime/ runtime/log/，确认 Web 进程用户（如www-data、nginx或apache）对这两个目录有写权限；必要时运行：chown -R www-data:www-data runtime/ - 若用 Swoole 或 Worker 模式，
LOG_PATH可能指向独立路径（如/tmp/think-log），需单独检查该路径是否存在、可写
数据库连不上却只报500，不提示密码错或 host 不通
当 APP_DEBUG = false 时，PDO 连接失败抛出的 PDOException 会被框架捕获并转成通用 500 页面，原始异常信息全丢弃。你看到的只是表象，不是根因。
实操建议：
- 临时在
app/common.php开头插入：ini_set('display_errors','1'); error_reporting(E_ALL);，强制让 PDO 异常浮出水面 - 命令行直连验证：
php -r "new PDO('mysql:host=127.0.0.1;port=3306;dbname=test', 'root', 'pass'); echo 'OK';"，避免被框架中间层干扰 - 检查 MySQL 是否启用了
skip-networking，或云服务器安全组是否封了 3306 端口；telnet your-host 3306能通才是第一步
Apache/Nginx 路由变量缺失导致初始化就崩
ThinkPHP 依赖 $_SERVER['PATH_INFO'] 或 $_SERVER['REQUEST_URI'] 解析路由。如果 Web 服务器没把原始请求路径透传进来（比如 Nginx 没配 fastcgi_param PATH_INFO $fastcgi_path_info;），框架在 App::run() 前就可能因数组索引不存在而 fatal error，且不记日志、不报错、只返回 500。
实操建议：
- Nginx 用户检查
location ~ \.php$块内是否包含：include fastcgi_params;和fastcgi_param PATH_INFO $fastcgi_path_info; - Apache 用户确认
.htaccess是否生效，或是否启用了mod_rewrite；如用 Apache 2.4+，还需检查AllowOverride All是否允许重写规则 - 在入口文件
public/index.php顶部加一行：var_dump($_SERVER['PATH_INFO'] ?? 'MISSING', $_SERVER['REQUEST_URI'] ?? 'MISSING'); die;，看关键变量是否存在
最常被忽略的一点：500 错误本身不是终点，而是线索断点。它背后可能是权限、编码、环境变量、Web 服务器配置、日志开关任意一环的失效 —— 别急着改代码，先确认错误有没有真正“发生”并“留下痕迹”。
