在 java 项目中配置 hibernate sql 日志,核心做法是修改日志框架(如 logback 或 log4j2)的配置文件,将 hibernate 包的日志级别调整为 debug。具体需要设置 org.hibernate.sql 为 debug 以输出原始 sql 语句,同时设置 org.hibernate.type.descriptor.sql.basicbinder 为 trace 以打印参数绑定值。这样配置后,控制台或日志文件中会清晰显示执行的 sql 及对应的参数,便于排查数据访问问题。

Logback 中如何配置 SQL 和参数日志
在 Spring Boot 或标准 Java 项目中使用 Logback 时,需在 logback.xml 中添加特定的 logger 配置。通过指定包名并设置级别,可以精确控制日志输出内容。以下是一个完整的 logback.xml 示例,展示了如何配置 Hibernate 相关日志。
<?xml version="1.0" encoding="UTF-8"?><configuration><appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"><encoder><pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender><!-- 开启 Hibernate SQL 日志 --><logger name="org.hibernate.SQL" level="DEBUG"></logger><!-- 开启 Hibernate 参数绑定日志 --><logger name="org.hibernate.type.descriptor.sql.BasicBinder" level="TRACE"></logger><root level="INFO"><appender-ref ref="STDOUT"></appender-ref></root></configuration>
运行包含实体查询的代码后,日志输出将包含类似以下的信息:
10:00:00.123 [main] DEBUG o.h.SQL - select user0_.id as id1_0_, user0_.name as name2_0_ from users user0_ where user0_.id=? 10:00:00.125 [main] TRACE o.h.t.d.s.BasicBinder - binding parameter [1] as [BIGINT] - [1]
Log4j2 中如何配置 SQL 和参数日志
如果项目使用 Log4j2,则需要在 log4j2.xml 中进行相应配置。与 Logback 类似,通过添加 logger 元素来指定包名和级别。以下是 log4j2.xml 的配置示例。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
<?xml version="1.0" encoding="UTF-8"?><configuration status="WARN"><appenders><console name="Console" target="SYSTEM_OUT"><patternlayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"></patternlayout></console></appenders><loggers><!-- 开启 Hibernate SQL 日志 --><logger name="org.hibernate.SQL" level="debug" additivity="false"><appenderref ref="Console"></appenderref></logger><!-- 开启 Hibernate 参数绑定日志 --><logger name="org.hibernate.type.descriptor.sql.BasicBinder" level="trace" additivity="false"><appenderref ref="Console"></appenderref></logger><root level="info"><appenderref ref="Console"></appenderref></root></loggers></configuration>
配置完成后,执行相同的查询操作,日志输出将与 Logback 配置下的结果一致,显示 SQL 语句和绑定的参数值。这种配置方式确保了在不同日志框架下都能获得详细的 SQL 执行信息,有助于开发者快速定位数据库交互中的问题。
Hibernate SQL 日志在事务提交时的行为表现
当 Hibernate 执行批量插入或更新操作时,SQL 日志会在事务提交或 flush 时集中输出。例如,在一个事务中多次调用 save() 方法,SQL 语句不会立即执行,而是在事务结束或显式调用 flush() 时才生成日志。这种行为由 Hibernate 的持久化上下文管理决定,旨在优化数据库交互性能。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










