线上开启APP_DEBUG报500是因为PHP配置不满足调试前提（如display_errors=Off），框架主动兜底；需检查PHP错误配置、runtime目录权限、LOG_RECORD开关及Web服务器路由配置。
为什么线上开启APP_DEBUG会报500而不是显示错误？
因为ThinkPHP在APP_DEBUG = true时，若环境不满足调试前提（比如缺少display_errors=On或error_reporting被禁用），框架会主动抛出500——它不是没报错，而是“想报但报不出来”，转而用500兜底。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先确认PHP配置：
php -i | grep -E "display_errors|error_reporting"，确保display_errors为On，error_reporting不低于E_ALL - 检查
runtime/目录是否可写，否则即使开启调试，日志也写不进runtime/log/，框架可能静默失败 -
APP_DEBUG只应在开发/测试环境开启，生产环境必须为false，靠日志定位问题
如何让500错误真正落地到日志文件？
ThinkPHP默认日志行为受LOG_LEVEL和LOG_FILE控制，但更关键的是LOG_RECORD是否启用——它决定是否记录异常堆栈。很多部署后日志为空，就是因为这个开关关着。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
config/app.php中显式设置：'log' => [<br> 'record' => true,<br> 'level' => ['error', 'sql'],<br> 'type' => 'File',<br>],
- 确保
runtime/log/存在且Web用户（如www-data、nginx）有写权限：chown -R www-data:www-data runtime/ - 如果用的是Swoole或Worker模式，日志路径可能独立于HTTP请求，需检查
LOG_PATH是否指向了不可达位置
常见500触发点：数据库连接失败却没报具体错误
当database.php配置错误（如密码错、host不通、端口被封），ThinkPHP默认只抛 PDOException ，但在APP_DEBUG=false下会被捕获并渲染成500页面，不输出任何线索。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 临时在
app/common.php开头加一行强制报错：ini_set('display_errors', '1'); error_reporting(E_ALL);再刷新页面，看是否露出PDO连接失败详情 - 用命令行验证数据库连通性：
php -r "new PDO('mysql:host=your_host;dbname=your_db', 'user', 'pass'); echo 'OK';" - 检查MySQL是否启用了
skip-networking，或云服务器安全组是否放行了3306端口
Apache/Nginx配置遗漏导致500却不报错原因
ThinkPHP依赖PATH_INFO或REQUEST_URI解析路由，如果Web服务器未正确传递这些变量，框架初始化阶段就可能因$_SERVER缺失关键字段而崩溃，且不写日志。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- Apache需启用
mod_rewrite，并确认.htaccess生效；若用httpd.conf部署，要手动添加：<Directory "/path/to/public"><br> AllowOverride All<br> Require all granted<br></Directory>
- Nginx需在server块中显式传递PATH_INFO：
location / {<br> try_files $uri $uri/ /index.php?$query_string;<br>}注意不是/index.php?/$1这种过时写法 - 检查
$_SERVER['SCRIPT_NAME']是否为/index.php，如果不是（比如变成/public/index.php），说明入口文件路径配置和Web根目录不一致
runtime/目录权限问题，在Docker或宝塔部署中尤其高频——它不报错，不写日志，只安静地返回500。 
