先插入ini_set('display_errors','1')和error_reporting(e_all)暴露错误；再确认app_debug=true生效；最后检查php错误日志、web服务器日志及runtime/log目录权限。
新手搭建 ThinkPHP 项目一访问就报 500，页面空白、没提示、不报错——这很常见，但不是框架“坏了”，而是错误被主动屏蔽了。核心问题在于：ThinkPHP 在非调试模式下会静默吞掉所有 PHP 致命错误，只返回一个通用的 HTTP 500 状态码。
先让错误露出来
别急着改代码，第一步是让真实错误浮出水面：
- 打开 public/index.php，在第一行
<?php后立即插入两行：
error_reporting(E_ALL);
- 保存后刷新页面，看是否出现红色错误堆栈（比如
Class not found、Call to undefined function或Parse error） - 如果仍空白，说明错误发生在更早阶段（如 autoload 加载失败），需转向日志排查
检查 APP_DEBUG 和环境配置
ThinkPHP 是否开启调试模式，直接决定它是否愿意显示错误：
- 确认 .env 文件中存在且生效：
APP_DEBUG=true - 检查 config/app.php 中：
'show_error_msg' => true和'app_debug' => true - 注意：.env 的设置可能被 config/app.php 里的硬编码覆盖，优先以 config 文件为准
查日志：别只盯 runtime/log
新手常误以为日志只在 runtime/log/ 下，其实错误可能落在三个地方：
-
PHP 错误日志：运行
php -i | grep error_log查路径，再用tail -f /var/log/php_errors.log实时观察 -
Web 服务器日志：Nginx 是
/var/log/nginx/error.log，Apache 是/var/log/apache2/error.log -
ThinkPHP 运行时日志：确保
runtime/和runtime/log/目录存在，且 Web 进程用户（如 www-data、nginx）有写权限：chown -R www-data:www-data runtime/
高频原因快速过一遍
以下几类问题在新手部署中最容易踩坑：
-
扩展缺失：运行
php -m | grep -E "(pdo|mbstring|openssl|curl)"，缺任意一个都可能 500 - 目录权限不对：storage/ 和 runtime/ 必须可写，但重点不是 chmod 777，而是属主匹配 Web 进程用户
-
中文路径或主机名：Windows 下项目放 D:\我的项目\ 或电脑名含中文，易触发
Malformed UTF-8 characters错误 -
伪静态配置失效：Apache 没启用 mod_rewrite 或 .htaccess 被忽略；Nginx 漏写
fastcgi_param PATH_INFO $path_info，导致路由解析失败
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
