thinkphp生产环境报错不显示、日志为空、500无堆栈，主因是app_debug=false时框架默认屏蔽错误且跳过日志写入，需手动启用log.type与log.level、开启trace、修复runtime目录权限，并用curl-v分层定位故障点。
生产环境报错不显示、日志为空、500 页面没堆栈——不是代码突然坏了，是 ThinkPHP 默认把错误“藏起来”了。必须手动打开日志开关、确认权限、绕过框架拦截，才能看到真实错误。
log.level 没配，日志目录再干净也没用
ThinkPHP 在 APP_DEBUG = false（即生产环境）下，默认完全跳过日志写入逻辑，哪怕 runtime/log/ 目录存在且可写，里面也永远是空的。
- 检查
config/app.php中'log' => ['type' => 'File']是否启用（不能是注释状态） - 必须显式配置
'level' => ['error', 'sql', 'notice']，光有type不生效 - 若用环境变量控制，确保
LOG_LEVEL=error,sql在public/index.php加载框架前已定义
日志写了但没堆栈，trace 开关被关了
日志里只有一行 [ error ] 数据库连接失败，没有文件名、行号、变量上下文？大概率是 trace 选项没开。
- 在
config/log.php中确认'trace' => true已设置（TP6.1+ 默认为false） - 该选项只对
error和notice级别生效，info级别即使开启也不带堆栈 - 开启后日志体积明显增大，线上建议仅排查期临时启用，避免磁盘撑爆
日志路径写入失败，权限问题卡在 runtime 归属
错误提示类似 file_put_contents(runtime/log/202405.log): failed to open stream: Permission denied，根源常不在权限数字，而在用户归属不一致。
- 先查 PHP-FPM 进程用户：
ps aux | grep php-fpm（通常是www-data或nginx） - 执行
chown -R www-data:www-data runtime（替换为你实际的用户） - 避免直接
chmod 777 runtime；755对目录、644对文件足够，但runtime必须可写，子目录会自动继承 - Windows 下注意路径分隔符，用
DS常量或str_replace('/', DS, $path)替换硬写的/
curl -v 看一眼，先分清是哪一层崩了
别急着翻日志。500 可能来自 Nginx、PHP-FPM、数据库、甚至 SELinux，盲目查日志效率极低。
- 执行
curl -v https://yoursite.com/api/test，重点看三处：Server头（Nginx/Apache？）、Content-Type（是框架吐的 JSON 还是 Web 服务器兜底的 HTML？）、Connection是否被提前关闭 - 若响应头带
X-Powered-By: PHP/8.2.12却无正文，大概率是 PHP 启动即 fatal（如扩展未加载），此时查php -m和dmesg | tail - 直连 PHP-FPM 验证：
SCRIPT_FILENAME=/var/www/html/test.php SCRIPT_NAME=/test.php REQUEST_METHOD=GET cgi-fcgi -bind -connect /run/php/php8.2-fpm.sock
真正卡住人的，往往不是某个开关没开，而是多个配置组合失效：比如 log.level 配了但 trace 关着，或者日志路径绝对化了但 runtime 所属用户不对。每次改完，记得清缓存 php think clear 再验证。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
