thinkphp使用之日志记录与异常追踪【调试篇】-ThinkPHP-PHP中文网

thinkphp日志未写入、堆栈不全、sql错误难定位，根本原因是app_debug、log_record和runtime/log写权限三者缺一不可；log_record默认关闭，需显式启用；异常堆栈丢失多因exceptionhandle未调用parent::render；sql错误应通过db::listen或catch块中db::getlastsql()捕获，而非依赖失败前的getlastsql()。

thinkphp使用之日志记录与异常追踪【调试篇】

日志没写进去、异常堆栈看不全、SQL错在哪——不是配置漏了，就是执行时机不对。ThinkPHP的日志和异常追踪必须同时满足三个条件：APP_DEBUG开启、log channel允许该级别、runtime/log有写权限。

APP_DEBUG 和 LOG_RECORD 必须同时为 true

只开 APP_DEBUG 不等于日志能写进去。LOG_RECORD 是独立开关，控制日志是否真正落盘。ThinkPHP 6+ 中它默认关闭，哪怕 APP_DEBUG = true，Log::debug() 也静默丢弃。

确认 public/index.php 开头第一行是 define('APP_DEBUG', true);，且前面无空格/BOM/输出
在 config/app.php 中显式加：'LOG_RECORD' => true
检查 config/log.php 的默认 channel（如 'file'）中 'level' 是否包含 'debug' 或 'error'
runtime/log/ 目录需存在且 PHP 进程有写权限（Linux 下常见权限不足导致日志文件为空）

错误堆栈不完整？检查 ExceptionHandle 的 render 方法

框架抛出的异常被 app/ExceptionHandle.php 拦截后，如果 render() 方法里没调用父类逻辑或手动记录，原始堆栈就丢了。尤其自定义了 JSON 错误响应时，容易漏掉 trace 信息。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

确保 render() 方法中至少有一句：return parent::render($e);
若需额外记录，应在 render() 开头加：Log::error('Uncaught exception: ' . $e->getMessage(), ['trace' => $e->getTraceAsString()]);
不要在 render() 里直接 echo 或 exit，会中断框架异常流程，导致 Trace 面板不显示

SQL 错误定位：别只信 getLastSql()

Db::getLastSql() 返回的是上一条「成功执行」的 SQL；遇到语法错误、字段不存在（如 MySQL 1054）时，它可能还是旧语句，甚至为空。真要抓错的那条 SQL，得用监听。

临时调试：在出问题的方法开头加 Db::listen(function ($sql, $time, $explain) { dump($sql); });
永久生效：在 config/database.php 的连接配置里设 'trace' => true，再配合 Db::getLastSql() 放在 catch 块里
警惕 ->fetchSql(true)：它只生成 SQL 字符串，不执行，参数绑定是否生效无法验证，容易误判
MySQL 1054 错误在 ThinkPHP 中常因字段名写成驼峰（如 userName）但数据库是下划线（user_name）且未配 auto_write_timestamp 或 type_cast

Trace 面板不显示？优先查模板和缓存

页面底部没 Trace 浮层，90% 不是配置问题，而是输出被截断或模板没加载。Trace 是通过在视图末尾注入 HTML 实现的，任何提前 exit、ob_end_flush() 或模板中 {__NOCACHE__} 都会让它消失。

确认 config/app.php 中 'trace' => ['type' => 'html']（非 console）
清空 runtime/view/ 和 runtime/cache/，避免旧编译模板干扰
检查控制器是否用了 return json(...) 或 response()->code(200)->send() —— 这些跳过视图渲染，Trace 自然不出现
若用 Nginx，确认没开启 fastcgi_buffering off; 类似设置，否则 HTML 尾部可能被缓冲丢弃