jooq 默认在 debug 级别下通过 loggerlistener 记录执行的 sql 语句，但若日志未出现，通常源于 executelogging 设置被禁用、slf4j 绑定缺失或 logback 配置未正确生效。
jooq 默认在 debug 级别下通过 loggerlistener 记录执行的 sql 语句，但若日志未出现，通常源于 executelogging 设置被禁用、slf4j 绑定缺失或 logback 配置未正确生效。
jOOQ 提供了开箱即用的 SQL 日志能力，但其实际行为高度依赖配置与运行时环境。以下是关键排查点与对应解决方案：
✅ 1. 确保 Settings.executeLogging 已启用
该设置控制是否启用执行日志（包括 SQL 和绑定参数），默认为 true，但若显式设为 false，则无论日志级别如何都不会输出 SQL：
Configuration configuration = new DefaultConfiguration()
.set(new org.jooq.impl.DefaultConnectionProvider(dataSource))
.set(new Settings().withExecuteLogging(true)); // 显式启用（推荐）⚠️ 注意：若使用 Spring Boot + jOOQ Auto-configuration，可通过
spring.jooq.settings.execute-logging=true（YAML）或spring.jooq.settings.executeLogging=true（properties）启用。
✅ 2. 验证 SLF4J + Logback 正确集成
jOOQ 的 org.jooq.tools.JooqLogger 优先委托给 SLF4J；若 SLF4J API 存在但无具体实现（如 slf4j-simple 或 logback-classic），将自动回退至 java.util.logging（JUL），导致 Logback 配置失效。
请确认以下依赖已存在且版本兼容（以 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>
? 检查技巧：运行时执行
System.out.println(org.slf4j.LoggerFactory.getLogger("test").getClass())，应输出类似ch.qos.logback.classic.Logger—— 若为org.slf4j.helpers.NOPLogger或 JUL 相关类，则说明绑定失败。
✅ 3. Logback 配置需覆盖 jOOQ 包路径
确保 logback.xml 中明确启用 org.jooq 及其工具包的 DEBUG 日志：
<logger name="org.jooq" level="DEBUG" /> <!-- 可选：增强可读性，同时启用执行上下文 --> <logger name="org.jooq.tools.LoggerListener" level="DEBUG" />
并确认根 logger 不会拦截或覆盖该设置：
<root level="INFO"> <appender-ref ref="CONSOLE"/> </root>
✅ 4. （进阶）自定义 LoggerListener 验证行为
若仍无日志，可显式注册 LoggerListener 并调试其初始化：
DSLContext create = DSL.using(configuration
.set(new LoggerListener()) // 显式添加监听器
);启动时观察是否打印 LoggerListener is active 类似提示 —— 若无，则说明监听器未注册成功。
总结
jOOQ SQL 日志“静默”通常不是 Bug，而是配置链中某环断裂：
? Settings.executeLogging = false → 优先检查代码/配置；
? SLF4J 绑定缺失 → 检查 classpath 是否含 logback-classic.jar 且无多个 SLF4J 实现冲突；
? Logback 级别未生效 → 使用 --debug 启动 Spring Boot 或添加 <statuslistener class="ch.qos.logback.core.status.OnConsoleStatusListener"></statuslistener> 查看内部日志器状态。
完成上述校验后，执行任意 jOOQ 查询（如 create.selectFrom(table).fetch()），即可在控制台看到结构清晰的 DEBUG 日志，包含完整 SQL、绑定参数及执行耗时。
