本文详解 jOOQ 在启用 DEBUG 日志级别后仍不打印 SQL 查询的三大核心原因：Settings.executeLogging 被禁用、SLF4J 绑定缺失或 Logback 配置不当，并提供可立即生效的配置示例与验证步骤。
本文详解 jooq 在启用 debug 日志级别后仍不打印 sql 查询的三大核心原因：`settings.executelogging` 被禁用、slf4j 绑定缺失或 logback 配置不当，并提供可立即生效的配置示例与验证步骤。
jOOQ 默认支持通过 LoggerListener（内置监听器）在 DEBUG 级别下自动记录执行的 SQL 语句、绑定参数及执行结果。但该功能并非仅依赖日志框架配置，而是受多个关键因素协同控制。以下为系统性排查与修复方案：
✅ 1. 确保 executeLogging 设置为 true
jOOQ 的 Settings.executeLogging 控制是否启用执行时的日志输出，默认值为 true，但若代码中显式设为 false，则无论日志级别如何均不会输出 SQL：
DSLContext create = DSL.using(connection, SQLTemplates.DEFAULT,
new Settings().withExecuteLogging(true) // 显式启用（推荐）
);⚠️ 注意：若使用 Spring Boot + jOOQ Starter，需检查 JooqAutoConfiguration 是否被自定义 Settings 覆盖；建议在 @Bean DSLContext 构建时显式设置：
@Bean
public DSLContext dsl(DataSource dataSource) {
return DSL.using(dataSource, SQLTemplates.DEFAULT,
new Settings().withExecuteLogging(true)
);
}✅ 2. 验证 SLF4J 绑定完整性
jOOQ 的 org.jooq.tools.JooqLogger 优先委托给 org.slf4j.Logger，仅当 SLF4J API 及其实现（如 logback-classic）同时存在于 classpath 时，DEBUG 日志才会路由至 Logback。常见错误包括：
- 仅引入
slf4j-api，但缺少logback-classic（导致回退到java.util.logging，而后者通常未配置 DEBUG 输出）； - 存在多个 SLF4J 绑定（如
slf4j-log4j12和logback-classic共存），引发冲突警告并静默失效。
✅ 正确依赖（Maven 示例）：
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.4.14</version> <!-- 请使用最新稳定版 -->
</dependency>
<!-- 确保无其他 SLF4J binding（如 slf4j-log4j12、slf4j-simple） -->✅ 3. 正确配置 Logback 日志级别
即使 SLF4J 绑定正确，仍需确保 Logback 将 org.jooq 包设为 DEBUG 级别。在 logback.xml 中添加：
<configuration>
<root level="INFO">
<appender-ref ref="CONSOLE"/>
</root>
<!-- 关键：启用 jOOQ 执行日志 -->
<logger name="org.jooq" level="DEBUG" additivity="false">
<appender-ref ref="CONSOLE"/>
</logger>
</configuration>? 验证技巧：启动应用后，搜索日志中是否出现类似以下内容（表明 jOOQ 日志已成功接入 SLF4J）：
DEBUG org.jooq.tools.LoggerListener - Executing query : select "id", "name" from "user" where "id" = ? DEBUG org.jooq.tools.LoggerListener - Binding variable 1 to index 1 : 123
? 总结
jOOQ SQL 日志“失灵”本质是 执行开关（executeLogging）+ 日志门面（SLF4J）+ 日志实现（Logback） 三者协同失败。务必按顺序检查：
① Settings.withExecuteLogging(true)；
② classpath 中存在且仅存在 slf4j-api + logback-classic；
③ Logback 配置中 org.jooq logger 明确设为 DEBUG。
完成上述三项后，SQL 日志将稳定输出，显著提升开发与调试效率。
