Symfony 7.0 默认不记录数据库查询日志,需手动配置 MonologLogger 实例并绑定到 DBAL 的 logger 选项,否则即使 dev 环境、启用 doctrine.dbal.logging 或 doctrine.orm.debug 也无实际 SQL 输出;推荐按需启用慢查或错误日志,避免性能损耗。

Symfony 7.0 默认不记录数据库查询日志,必须显式启用并配置 Doctrine 的 SQL Logger —— 否则 doctrine.dbal.logging 配置项无效,doctrine.orm.debug 也只影响 DQL 解析,不输出实际执行的 SQL。
为什么 dev 环境看不到 SQL 日志?
Symfony 7.0+ 移除了默认的 DebugStack SQL logger,即使 APP_ENV=dev,Doctrine 也不会自动把查询写入日志。你看到的“SQL logged”只是 Profiler 的内存快照,不落地、不可检索、不触发 Monolog 处理器。
-
doctrine.dbal.logging: true在config/packages/doctrine.yaml中仅启用内部日志收集,但无输出目标 -
doctrine.orm.debug: true只让 ORM 显示 DQL 编译过程,和实际执行的 SQL 无关 - 未配置
logger实例时,DebugStack不会自动挂载,doctrine:debug:sql命令也查不到历史记录
手动注入 MonologLogger 到 Doctrine 连接
最直接的方式是把 LoggerInterface(指定 channel)绑定到 DBAL 连接的 logger 选项,让每条 SQL 经由 Monolog 处理器输出:
doctrine:
dbal:
# ... 其他配置
options:
# 注意:key 是 'logger',不是 'logging'
logger: '@monolog.logger.doctrine'然后在 config/services.yaml 中定义该 logger 实例:
services:
monolog.logger.doctrine:
class: Monolog\Logger
arguments: ['doctrine']
calls:
- [pushHandler, ['@monolog.handler.doctrine_file']]
monolog.handler.doctrine_file:
class: Monolog\Handler\StreamHandler
arguments: ['%kernel.logs_dir%/doctrine.log', 'debug']- 必须用
@monolog.logger.doctrine而非logger_interface,否则 Doctrine 拒绝接受 PSR-3 接口实例 -
StreamHandler路径要确保var/log/可写;若需轮转,改用RotatingFileHandler并传入7(天数)而非'7 days' - 避免在生产环境启用,SQL 日志量极大,且含敏感参数(即使参数化,语句本身可能暴露逻辑)
只记录慢查询或错误 SQL
全量 SQL 日志对排查无帮助,反而掩盖问题。建议用 FingersCrossedHandler + 自定义处理器过滤:
monolog:
handlers:
doctrine_slow:
type: fingers_crossed
action_level: warning
handler: doctrine_file_slow
# 触发条件:SQL 执行超 500ms 或含 ERROR 关键字
processor: 'App\Monolog\SqlSlowProcessor'
doctrine_file_slow:
type: stream
path: '%kernel.logs_dir%/doctrine-slow.log'
level: debugSqlSlowProcessor 需实现 __invoke(),检查 $record['context']['executionMS'] 或 $record['message'] 是否含 ERROR: —— Doctrine 在日志上下文中会注入 executionMS 和 sql 字段。
- 不要依赖
level: warning自动过滤:Doctrine 的 SQL 日志固定用info级别,必须靠 Processor 拦截 - 若用
consolehandler,注意process_psr_3_messages: false,否则 SQL 日志会被格式化成带颜色的单行,丢失换行与上下文 - SQL 参数不会被自动脱敏,如需隐藏密码字段,得在 Processor 中正则替换
password = '[^']*'
真正难的是平衡可观测性与性能损耗:每条 SQL 都走 Monolog 栈、序列化上下文、IO 写入,高并发下容易拖慢响应。线上只开慢查或错误捕获,开发环境再开全量,并记得定期清理 doctrine.log —— 它不会自动轮转,哪怕你配了 RotatingFileHandler,Doctrine 仍可能绕过它直写 StreamHandler。


















