jOOQ SQL 查询不打印日志？三步定位并修复日志缺失问题-java教程-PHP中文网

jOOQ SQL 查询不打印日志？三步定位并修复日志缺失问题

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"></logger><!-- 可选：同时开启 jOOQ 核心调试（如解析、渲染细节） --><logger name="org.jooq.impl.DefaultDSLContext" level="TRACE"></logger><root level="INFO"><appender-ref ref="CONSOLE"></appender-ref></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

一句话排查清单：