为什么Hyperf生成的SQL语句在日志中显示不完整_配置DB组件开启SQL监听器

小磊大大_4194

小磊大大_4194

2026-05-20

527人浏览

原创

Hyperf默认不记录完整SQL,需在db.php中启用log_sql=>true并设置PDO::ATTR_EMULATE_PREPARES=>true;若仍截断,还需调整Monolog LineFormatter的max_length参数,并注意生产环境敏感信息泄露风险。

为什么hyperf生成的sql语句在日志中显示不完整_配置db组件开启sql监听器

Hyperf 日志里 SQL 被截断,不是日志配置问题,而是 DB 组件默认关了完整 SQL 记录

Hyperf 的 db 组件默认不记录完整 SQL(尤其是带大量参数的 INSERT/UPDATE),即使你把 logger 级别调成 debug,也只会看到类似 INSERT INTO users VALUES (?, ?, ?) 这种占位符形式。这不是 Monolog 截断,是 DB 层压根没把绑定参数拼进去。

开启 PDOStatement::getAttribute(PDO::ATTR_DRIVER_NAME) 后才能触发完整 SQL 日志

Hyperf 底层用的是 Swoole 协程 PDO 封装,SQL 日志是否“展开参数”,取决于 DbLogger 是否调用了 getSQL() 方法——而该方法只在启用 log_sql 且驱动支持时才生效。常见误区是以为改 logger.php 就够,其实必须先打开 DB 配置开关:

  • config/autoload/db.php 中确保 'options' => [PDO::ATTR_EMULATE_PREPARES => true] 已设置(否则部分驱动如 MySQLi 不返回完整 SQL)
  • 在 'logger' 子项中显式启用:'log_sql' => true(默认为 false)
  • 若使用 MySQL,建议同时加 PDO::MYSQL_ATTR_DIRECT_QUERY => false,避免绕过预处理导致日志丢失参数

日志仍被截断?检查 formatter 的 max_length 和 monolog 默认限制

即使 DB 层吐出了完整 SQL,Monolog 的 LineFormatter 默认会把 message 字段截到 10000 字符(约 10KB)。你在 config/autoload/logger.php 里看到的 'formatter' 配置,如果没显式传 max_length,就走 Monolog 内置默认值:

hyperframes-超帧视频
hyperframes-超帧视频

HTML 驱动的视频合成——GSAP 动画、TTS 字幕、音频响应、着色器转场

下载
  • 找到 'formatter' => ['class' => LineFormatter::class, 'constructor' => [...]]
  • 在 constructor 数组第 5 个位置(索引 4)传 null,表示不限长;或传一个足够大的整数,比如 50000
  • 注意:设太大可能撑爆内存或让日志文件难以查看,建议按实际最长 SQL 长度 + 20% 浮动设置

生产环境慎用 full SQL 日志,尤其含敏感字段时

开启 log_sql => true 后,所有参数(包括密码、token、手机号)都会明文写入日志文件。这不是 bug,是设计行为。如果你只是想排查慢查询或语法错误,更安全的做法是:

  • 临时开启,查完立刻关掉
  • 配合 level 控制,比如只在 app_env === 'dev' 时启用
  • 用 DB::listen() 回调做条件过滤,例如只记录执行时间 > 100ms 的 SQL:if ($event->time > 100) { \Hyperf\Logger\LoggerFactory::get('slowsql')->info($event->sql, $event->bindings); }

协程环境下,DB::listen() 是比改全局配置更轻量、更可控的日志介入点,且能直接拿到已解析的 $event->sql 和 $event->bindings,无需担心 formatter 截断。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

hyperf sql语句

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

4823

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

991

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1269

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

6861

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3543

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

6840

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

9501

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1290

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1132

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Hyperf官方中文手册(3.1)
Hyperf官方中文手册(3.1)

共0课时 | 0人学习

Swoole系列-从0到1-新手进阶
Swoole系列-从0到1-新手进阶

共29课时 | 2.4万人学习