需启用调试模式、配置record_trace和log.trace、验证异常处理器未覆盖，并可手动注入堆栈日志。具体包括检查.env中app_debug=true、log.php设record_trace=true和channels'file'=true、确保Handler.php调用parent::render、必要时用file_put_contents强制记录堆栈。
如果您在ThinkPHP项目中遇到500错误但日志中仅显示简略提示、缺失文件路径与行号，说明异常堆栈信息未被完整捕获和落盘。以下是实现异常堆栈详细记录的具体方法：
一、启用调试模式并确认环境变量优先级
调试模式是触发框架完整异常渲染与堆栈输出的前提，但其实际生效受环境变量控制，.env配置具有最高优先级。
1、检查项目根目录下的.env文件，确保存在且内容包含：app_debug=true
2、确认该行未被注释，且无空格或不可见字符干扰赋值
立即学习“PHP免费学习笔记（深入）”；
3、若使用命令行部署，需清除runtime/cache/目录下所有缓存文件以使.env变更生效
4、访问任意报错页面，观察是否出现带文件名、行号及调用链的蓝色异常面板
二、配置日志通道启用堆栈记录开关
即使开启调试模式，生产环境日志仍需显式启用堆栈跟踪记录，否则仅写入单行error消息，不包含trace信息。
1、打开config/log.php文件，在return数组顶层添加配置项：'record_trace' => true
2、检查'level'数组是否包含'error'和'warning'，模型事件异常常以warning级别发出
3、确保'default'通道指向'file'，且channels['file']['type']为'File'
4、验证runtime/log/目录权限为可写，避免因磁盘权限导致日志静默失败
三、强制开启log.trace配置项（TP6.1+必需）
ThinkPHP 6.1及以上版本默认关闭trace日志，此选项独立于record_trace，专用于控制error与notice级别日志是否携带完整堆栈。
1、定位到config/log.php中channels['file']子数组内部
2、在该数组中加入键值对：'trace' => true
3、注意该配置仅对error和notice生效，info级别日志即使开启也不含堆栈
4、修改后清空runtime/log/下全部旧日志，触发新配置立即生效
四、验证全局异常处理器未被覆盖
自定义异常处理器若未正确委托父类处理，将直接屏蔽框架原生堆栈渲染逻辑，导致页面仅返回空白或HTTP 500状态码。
1、检查app/exception/Handler.php是否存在
2、打开该文件，确认render()方法中对非AJAX请求是否调用parent::render($request, $e)
3、若存在return json(...)或echo等直接响应语句，需删除或改为条件判断
4、临时重命名该文件，观察异常页面是否恢复为标准ThinkPHP调试视图，以此反向确认覆盖问题
五、手动注入堆栈到日志文件（兜底方案）
当上述配置均无效时，可在全局中间件或基础控制器中插入强制日志写入逻辑，绕过框架日志驱动限制。
1、在app/middleware/CheckExceptionLog.php中定义handle方法
2、在try块内执行$next($request)，catch块中获取$e->getTraceAsString()
3、构造完整日志字符串，包含date('Y-m-d H:i:s')、$e->getFile()、$e->getLine()及堆栈
4、调用file_put_contents(runtime_path('log/force_trace.log'), $log . "\n", FILE_APPEND | LOCK_EX)
