jOOQ 默认在 DEBUG 级别下通过 LoggerListener 输出执行的 SQL 语句，若未见日志，通常因 Settings.executeLogging = false、SLF4J 绑定缺失或 Logback 配置未生效所致。
jooq 默认在 debug 级别下通过 `loggerlistener` 输出执行的 sql 语句，若未见日志，通常因 `settings.executelogging = false`、slf4j 绑定缺失或 logback 配置未生效所致。
要使 jOOQ 正确输出 SQL 日志（如 Executing query : SELECT * FROM author WHERE id = ?），需同时满足三个关键条件：
✅ 1. 启用 jOOQ 执行日志开关（最常见遗漏项）
jOOQ 的日志行为由 Settings.executeLogging 控制，默认为 true，但若显式设为 false，即使 Logback 配置正确也完全静默。请检查 DSLContext 构建时是否禁用了该选项：
Settings settings = new Settings()
.withExecuteLogging(false); // ❌ 错误：这会彻底关闭 SQL 日志！
DSLContext create = DSL.using(connection, dialect, settings);✅ 正确做法（显式启用，确保无覆盖）：
Settings settings = new Settings()
.withExecuteLogging(true); // 显式开启（推荐，提高可维护性）
DSLContext create = DSL.using(connection, dialect, settings);? 提示：
executeLogging仅控制 SQL/绑定值/执行耗时等运行时日志，不影响LoggerListener本身的注册状态。
✅ 2. 确保 SLF4J 正确绑定 Logback
jOOQ 内部使用 org.jooq.tools.JooqLogger，其优先尝试加载 org.slf4j.Logger；若失败，则回退到 java.util.logging（JUL），而 JUL 不受 Logback 配置影响。
请验证以下依赖已声明且无冲突（Maven 示例）：
<!-- 必须存在 --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>2.0.13</version> </dependency> <!-- 必须存在，且与 slf4j-api 版本兼容 --> <dependency> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> <version>1.4.14</version> </dependency> <!-- 禁止出现以下任一依赖（会导致桥接冲突） --> <!-- <dependency><groupId>org.slf4j</groupId><artifactId>slf4j-simple</artifactId></dependency> --> <!-- <dependency><groupId>org.slf4j</groupId><artifactId>slf4j-jdk14</artifactId></dependency> -->
运行时可通过代码快速验证绑定是否生效：
System.out.println(org.slf4j.LoggerFactory.getLogger("test").getClass().getName());
// ✅ 正确输出应类似：ch.qos.logback.classic.Logger
// ❌ 若输出 org.slf4j.helpers.NOPLogger 或 JUL 相关类，则绑定失败✅ 3. Logback 配置精准匹配 jOOQ 日志器路径
org.jooq.tools.LoggerListener 的日志器名称为 "org.jooq.tools.LoggerListener"，而非 "org.jooq"。因此，仅配置 org.jooq 包级别为 DEBUG 是不够的。
请在 logback.xml 中明确指定：
<configuration>
<!-- 关键：必须针对 LoggerListener 类本身 -->
<logger name="org.jooq.tools.LoggerListener" level="DEBUG" />
<!-- 可选：同时开启 jOOQ 核心调试（如解析、渲染细节） -->
<logger name="org.jooq.impl.DefaultDSLContext" level="TRACE" />
<root level="INFO">
<appender-ref ref="CONSOLE" />
</root>
</configuration>⚠️ 注意：
LoggerListener是 jOOQ 的默认监听器，无需手动注册——只要executeLogging=true且日志框架就绪，它即自动生效。
✅ 验证与总结
完成上述三项后，执行任意 jOOQ 查询（如 create.selectFrom(table).fetch()），控制台应立即输出类似内容：
DEBUG org.jooq.tools.LoggerListener - Executing query : select "author"."id", "author"."first_name", "author"."last_name" from "author" DEBUG org.jooq.tools.LoggerListener - -> with bind values : select "author"."id", "author"."first_name", "author"."last_name" from "author" DEBUG org.jooq.tools.LoggerListener - Affected row count : 5
一句话排查清单：
- 检查
Settings.executeLogging是否为true； - 运行
LoggerFactory.getLogger(...)验证 SLF4J → Logback 绑定； - Logback 配置中
logger名称是否精确等于org.jooq.tools.LoggerListener。
修复任一缺失环节，SQL 日志即可稳定输出。
