ThinkPHP5.1 500白屏本质是PHP错误被屏蔽，需同时开启app_debug=true、PHP error_reporting与display_errors，并检查runtime日志、环境兼容性及中间件干扰。
ThinkPHP5.1 出现 500 白屏，本质是 PHP 执行出错但错误未显示。默认关闭错误提示、日志未开启或配置拦截，都会导致页面空白。关键不是“看不到错误”，而是“没让错误浮出来”。
开启调试模式和错误显示
确保 app_debug 为 true，且 PHP 自身错误报告打开：
- 检查 application/config.php 中
'app_debug' => true - 确认 public/index.php 末尾没有注释掉
ini_set('display_errors', 'On');或类似屏蔽语句 - 在入口文件顶部临时加一行：
error_reporting(E_ALL); ini_set('display_errors', '1');，绕过框架配置直接强制报错
查看运行时日志文件
TP5.1 默认将错误写入 runtime/log/年-月/日.log，这是最可靠的线索来源：
- 确认 runtime/ 目录可写（755 或 777，视服务器而定）
- 用
tail -f runtime/log/2026-10/27.log实时观察最新错误（Linux/macOS） - 常见日志内容如
[ error ] [500] SQLSTATE[HY000] [1045] Access denied for user...或Call to undefined method think\Request::xxx()，直接定位问题类型
检查配置与环境兼容性
500 白屏常由基础环境或配置异常引发，而非业务代码：
立即学习“PHP免费学习笔记（深入）”；
- 确认 PHP 版本 ≥ 7.1（TP5.1 最低要求），且禁用了
short_open_tag（否则解析模板失败静默报错） - 检查 database.php 是否存在语法错误（如末尾多逗号）、数据库账号密码错误、连接超时未捕获
- 验证 route.php 是否有非法闭包或未引入类，尤其升级后遗留的 TP5.0 风格路由写法
- 若使用 Apache，确认
.htaccess正确；Nginx 则检查是否遗漏try_files $uri $uri/ /index.php?$query_string;
临时禁用中间件与钩子
某些自定义中间件、全局过滤或行为扩展（behavior）会在请求早期崩溃，导致白屏无日志：
- 注释 application/middleware.php 中全部中间件，逐步启用排查
- 在 application/tags.php 中清空数组，排除行为扩展干扰
- 新建一个极简控制器（如
Test.php），不继承任何基类、不调用模型、不读配置，仅返回字符串，确认是否仍白屏——可判断是否为框架核心或环境问题
