需启用调试模式并配置日志:设app_debug=true,database.php中开启log和sql_explain,tp6.1+还需log.level包含sql;用event监听db_query事件获取sql与耗时,避免db::listen()(已移除);慢查阈值应按业务动态设定,并监控频次告警。

如何开启ThinkPHP的SQL日志记录
默认情况下ThinkPHP不会输出完整SQL,必须手动启用调试模式并配置日志级别。否则Db::getLastSql()可能返回空,或think\db\Connection的查询耗时根本不会被采集。
- 确保
app_debug为true(config/app.php中),否则所有调试信息被屏蔽 - 在
config/database.php中设置'log' => true,同时指定'sql_explain' => true可自动对慢查询执行EXPLAIN - 若用的是ThinkPHP 6.1+,还需检查
log.level是否包含sql——否则think-sql日志通道不生效
怎样捕获单条查询的执行时间与SQL语句
靠Db::getLastSql()和Db::getRealSql()不够,它们只返回最后一条SQL,且不带时间戳;真正可用的是事件监听机制。
- 在
app/event.php中注册db_query事件:监听think\db\Query发出的query事件,参数含$sql、$time(毫秒)、$params - 避免在模型里用
debug_backtrace()手动计时——会干扰连接池复用,且无法覆盖原生Db::table()->select()等调用路径 - 注意
$time是数据库层返回结果的耗时,不含PHP解析、序列化开销;如需端到端监控,得在中间件里用microtime(true)套一层
为什么Db::listen()在TP6.0+里失效了
Db::listen()是ThinkPHP 5.x的写法,6.x已移除,直接调用会抛出Call to undefined method think\db\Connection::listen()错误。
- TP6.x统一使用
event系统:绑定think\db\Connection::EVENT_QUERY事件,回调函数接收QueryEvent对象 - 别漏掉
use think\Event\QueryEvent;,否则事件对象属性(如$event->sql、$event->time)无法访问 - 如果用了多数据库连接(
Db::connect('slave')),需为每个连接实例单独绑定事件,不能只绑默认实例
慢查询阈值怎么设才合理
把阈值设成50ms看似保守,但在高并发下可能刷屏日志;设成500ms又容易漏掉累积型性能退化。关键不是固定数字,而是结合业务节奏动态判断。
- 读接口(如列表页)建议阈值设为
200ms,写接口(如订单创建)放宽到800ms——因涉及事务和外键约束 - 避免全局硬编码:可在
config/database.php里加'slow_time' => env('DB_SLOW_TIME', 300),方便不同环境切换 - 真正要警惕的不是单次超时,而是同一SQL在
1分钟内出现3次以上超过阈值——这说明索引失效或数据倾斜,光记日志没用,得触发告警
Db::connect()之后才绑定事件,中间那几次查询就完全漏掉了。得确保事件注册发生在连接初始化阶段,而不是第一次select()之前。php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











