jooq 默认在 debug 级别下应自动记录执行的 sql 语句，但若日志未出现，通常源于 executelogging 设置被禁用、slf4j 绑定缺失或 logback 配置未正确覆盖 jooq 日志器。
jooq 默认在 debug 级别下应自动记录执行的 sql 语句，但若日志未出现，通常源于 executelogging 设置被禁用、slf4j 绑定缺失或 logback 配置未正确覆盖 jooq 日志器。
jOOQ 提供了开箱即用的 SQL 执行日志能力，但其行为依赖两个关键前提：日志配置生效 和 底层日志框架正确集成。即使你在 Logback 中为 org.jooq 设置了 DEBUG 级别（如 <logger name="org.jooq" level="DEBUG"></logger>），仍可能因以下原因导致 SQL 不输出：
✅ 1. 检查 Settings.executeLogging 是否被显式关闭
jOOQ 的 DSLContext 默认启用 SQL 日志（对应 LoggerListener），但该行为受 Settings.executeLogging 控制。若你在构建 DSLContext 时手动设为 false，日志将完全静默：
Settings settings = new Settings()
.withExecuteLogging(false); // ❌ 禁用日志 —— 常见误配！
DSLContext create = DSL.using(connection, dialect, settings);
✅ 修复方式：确保该设置为 true（默认值），或直接省略：
Settings settings = new Settings()
.withExecuteLogging(true); // ✅ 显式启用（推荐用于调试）
✅ 2. 确保 SLF4J + Logback 正确绑定至 jOOQ
jOOQ 内部使用 org.jooq.tools.JooqLogger，其优先尝试加载 org.slf4j.Logger；若失败，则回退到 java.util.logging（JUL），而 JUL 不会响应 Logback 配置。
⚠️ 常见陷阱：
- 项目中存在
slf4j-jdk14或slf4j-simple等冲突桥接器； -
slf4j-api版本与logback-classic不兼容； -
logback-classic未在 classpath/modulepath 中，或被其他日志实现遮蔽。
✅ 验证步骤：
- 确认依赖包含且仅含以下核心组件（Maven 示例）：
<dependency><groupid>org.slf4j</groupid><artifactid>slf4j-api</artifactid><version>2.0.13</version></dependency><dependency><groupid>ch.qos.logback</groupid><artifactid>logback-classic</artifactid><version>1.4.14</version></dependency>
- 运行时检查类加载：添加临时代码验证 SLF4J 绑定：
System.out.println(org.slf4j.LoggerFactory.getILoggerFactory()); // 应输出类似：ch.qos.logback.classic.LoggerContext
✅ 3. Logback 配置需覆盖 jOOQ 工具类日志器
jOOQ 的日志由 org.jooq.tools.LoggerListener 发出，其 logger 名为 org.jooq.tools.LoggerListener（而非 org.jooq）。因此，仅配置 org.jooq 不够充分。
✅ 推荐 Logback 配置（logback.xml）：
<configuration><!-- 确保 root logger 至少为 DEBUG --><root level="INFO"><appender-ref ref="CONSOLE"></appender-ref></root><!-- 关键：显式启用 LoggerListener 的 DEBUG 日志 --><logger name="org.jooq.tools.LoggerListener" level="DEBUG" additivity="false"><appender-ref ref="CONSOLE"></appender-ref></logger><!-- 可选：同时启用 DSLContext 执行上下文日志 --><logger name="org.jooq.impl.DSLContextImpl" level="DEBUG" additivity="false"><appender-ref ref="CONSOLE"></appender-ref></logger></configuration>
? 总结
jOOQ SQL 日志“失灵”极少是框架缺陷，绝大多数情况可归因于：
-
Settings.executeLogging = false被主动关闭； - SLF4J 绑定缺失或错误（导致回退到 JUL，脱离 Logback 管控）；
- Logback 配置未精准匹配 jOOQ 实际使用的 logger 名（如
org.jooq.tools.LoggerListener）。
完成上述三项检查并修正后，你将在控制台看到类似输出：
DEBUG org.jooq.tools.LoggerListener - Executing query : select "id", "name" from "author" where "id" = ? DEBUG org.jooq.tools.LoggerListener - -> with bind values : select "id", "name" from "author" where "id" = 1 DEBUG org.jooq.tools.LoggerListener - Affected row(s) : 1
至此，SQL 可视化调试能力即可稳定启用。
