于Boot开发里头，数据库交互常常是问题排查的重灾区所在之处。当应用出现性能方面的瓶颈或者数据出现异常状况时，怎样精准地定位SQL执行所存在的问题呢？本文整理了12个经过实战验证的调试技巧，从基础的SQL日志输出开始一直到高级的缓存监控，覆盖了在开发全流程当中的数据库调试需求范围。这些技巧是基于Boot 3.4.2版本来进行与实现的，所有配置均提供了能够直接复用的代码示例，并且标注了生产环境使用时的注意事项。

基础日志配置：开启SQL可视化开启SQL日志

核心价值在于，它是最为基础的调试手段，同时也是最为常用的调试手段，能够直接于控制台输出执行的 SQL 语句，进而帮助开发者迅速确认 ORM 框架是否生成了预期的查询。

实现步骤：在.yml中添加配置：

spring:
  jpa:
    show-sql: true

适用于开发环境之时的SQL生成验证场景，尤其适宜查证JPA查询方法或者JPQL语句是不是正确转变成为SQL，注意的要点是，此配置借.out予以输出而非历经日志框架，并且不会展现参数值，在生产环境当中必须将其禁用。

效果展示：

Hibernate，选择，b1_0的id，b1_0的描述，b1_0的国际标准书号，b1_0的页数，b1_0的价格，b1_0的标题，从book中，b1_0，限制，？，？，从哪里，至哪里，有多少，有多少，是多少，是多少，是多少，是多少，是多少，是多少，是标点，是标点，是标点，是标点，是标点。

格式化SQL

核心价值在于，解决那样一种问题，即原生 SQL 日志呈现出杂乱无章的状态，借助缩进以及分行的方式，使得 SQL 的结构变得清晰起来，进而大幅度提升读取的可理解程度。

实现步骤：在开启show-sql的基础上添加格式化配置：

spring:
  jpa:
    properties:
      hibernate:
        '[format_sql]': true

适合应用于，复杂SQL句话的结构剖析，特别是多表关联查询或者包含子查询的情景之中。需要留意的是，它必须要和show-sql=true共同使用才能够产生效果。

效果展示：

Hibernate:
    select
        b1_0.id,
        b1_0.description,
        b1_0.isbn,
        b1_0.page,
        b1_0.price,
        b1_0.title
    from
        book b1_0
    limit
        ?, ?

高亮SQL

首先，核心价值，在于，通过ANSI颜色代码，来区分SQL关键字，以及表名，还有参数占位符，达到使控制台输出的SQL呈现出，如同IDE中一样的，具有语法高亮效果 。

实现步骤：添加高亮配置：

spring:
  jpa:
    properties:
      hibernate:
“[突出显示SQL]”：为真， 那个值是真的 ，它呈现出真的状态 。

适用场景：所有那些需要很快识别SQL结构的场景，格外适合于在数量很多的日志里定位SQL语句。注意事项：仅仅是在支持ANSI颜色的控制台或者IDE当中会生效（像是IDEA、VS Code终端）。

高级日志控制：从参数到事务显示SQL参数

关键价值在于，处理基础SQL日志仅仅呈现占位符也就是(?)，却不展示实际参数数值的状况，毫无遗漏地复原执行的SQL语句 。

实现步骤：通过日志级别配置实现：

logging:
  level:
“[org.hibernate.SQL]”，对于调试而言。
“[org.hibernate.orm.jdbc.bind]”，处于TRACE级别 。

被适用的场景：针对参数绑定方面出现的错误从而展开排查，尤其是那种会因为动态查询条件而致使SQL逻辑产生问题的情况，需要注意的事项：TRACE级别日志输出的数量是比较大的，在生产环境中要慎重地使用 。

效果展示：

21时07分，调试，[主程序]，组织，Hibernate，SQL，选择，若干内容，从，书籍，b1_0，限制，若干参数，若干参数，句号。
时间是21:07，类别为TRACE，所在线程是main，涉及的类是org.hibernate.orm.jdbc.bind，内容是绑定参数，参数类型为(1:INTEGER) 。<- [0]
21:07 TRACE [main] org.hibernate.orm.jdbc.bind - binding parameter (2:INTEGER) <- [20]

显示事务日志

关键价值在于，对事务的整个完整生命周期予以监控，这其中涵盖事务启动、提交以及回滚等这些关键节点，从而解决关于事务边界存在的问题。

实现步骤：配置事务日志级别：

logging:
  level:
隶属于“[org.hibernate.engine.transaction]”的，处于调试状态的，信息。

适用的场景为，分布式事务相关问题的排查，事务传播行为的验证，事务超时或者回滚原因的分析。需要注意的事项是，建议跟事务注解（@）搭配使用，以此来获取最佳的效果。

显示SQL注释

核心价值在于，于所生成的SQL里，添加上下文注释，且标明相关查询的来源或者目的，以此便于在复杂系统之中，追踪SQL产生的位置。

实现步骤：开启SQL注释并结合@Meta注解自定义：

spring:
  jpa:
    properties:
      hibernate:
将其改写为：“[使用SQL注释]”（这里写的是“使用SQL注释”，而不是“use_sql_comments”）为真，。

自定义注释：

 {
    @Meta(comment = "分页查询所有图书信息")
    Page findAll(Pageable pageable);
}

可适用的场景是，多模块应用或者复杂查询的SQL溯源，尤其特殊适合的是，微服务架构里的数据库操作跟踪。

性能优化与监控显示慢SQL

关键价值在于，能够自动去识别，还要记录下来，那些执行时间超出阈值的SQL语句，并且能够快速地定位其性能瓶颈所在。

实现步骤：配置慢查询阈值和日志级别：

spring:
  jpa:
    properties:
      hibernate:
它表示，“[log_slow_query]这个标识或内容”，对应的数值是200，这里的200是用于表示一种特定的、与慢查询相关的阈值，单位是毫秒 。
logging:
  level:
对于“[org.hibernate.SQL_SLOW]”，呈现出的是信息 。 ， 。

适用的场景有，应用性能的优化，数据库查询效率的分析，建议在开发环境以及测试环境之中，设置较低的阈值，比如说200毫秒，而生产环境则要依据需求去进行调整。

生成原始SQL语句

核心价值在于，输出被发送到数据库的原始SQL语句，并未经过哪怕任何一丝一毫的格式化处理过程，是最为接近数据库执行时的实际真实语句的那种语句。

实现步骤：配置特定日志级别：

logging:
  level:
    '[org.hibernate.SQL]': DEBUG

有着这样的适用场景，那就是对数据库兼容性问题予以排查，又或是存在那种需要在数据库客户端直接去执行调试的景况。需要留意的事项就是，所输出的SQL涵盖占位符，得配合参数日志来加以使用。

缓存与统计分析二级缓存&查询缓存日志

核心价值在于，监控二级缓存的命中状况，还要监控查询缓存的命中情形，进而通过优化缓存策略，以此来提升性能 。

实现步骤：配置缓存日志级别：

logging:
  level:
缓存相关的，属于Hibernate范畴的，处于调试状态的，名为org.hibernate.cache的部分: 调试。

使用场景为，缓存优化，以及缓存穿透、击穿问题排查，尤其适用于读多写少的应用场景 ，注意要点是，需要配合缓存注解（@等标识）来进行操作 。

显示统计跟踪信息

主要的价值在于，对运行时的指标予以收集，还要将其进行展示，这些指标涵盖了以下方面 ,有查询的次数 ,存在缓存的命中率 ,还有实体加载的数量等重要关键的性能数据 。

实现步骤：开启统计功能：

spring:
  jpa:
    properties:
      hibernate:
这是一个json格式的内容，其中包含一个键值对，键为'[generate_statistics]'，值为true ，标点符号使用逗号而非冒号等其他符号，这样的表述方式。
logging:
  level:
以“[org.hibernate.stat]”为起始，处于调试状态 。

统计信息包括：查询执行次数()、缓存命中率(

计数/计数)、用于实体加载所涉及的数量)、关乎集合加载所涵盖的数量)等具有关键性质的指标。

适用场景为，应用性能瓶颈进行分析，数据库交互予以优化，缓存策略展开评估 。注意事项有，统计功能会致使产生一定的性能开销，在生产环境之中建议，仅仅是在诊断问题的时候临时开启 。

获取数据日志（结果集提取）

核心价值在于，记录详细过程intellij idea 16，此过程是从数据库结果集映射到Java对象的过程，还要解决数据转换异常问题。

实现步骤：配置结果集提取日志：

logging:
  level:
关于“[org.hibernate.orm.jdbc.extract]”，处于TRACE级别 。

该适用场景为，字段类型映射出现错误，或者数据格式转换遭遇异常，更有复杂结果集映射问题的进行排查。注意的是，TRACE级别日志输出极为详细intellij idea 16，它会记录每一行数据的提取经历过程。

总结与最佳实践

以上12个技巧，将Boot应用里SQL调试的各个方面都涵盖了，其中包括从基础的SQL输出，到高级的缓存监控。在所实际使用期间，建议依据具体场景，对这些技巧进行组合使用：

牢记，所有的调试配置，于生产环境当中，默认是处于关闭状态的，仅仅是在有需要去诊断问题的情况之时，才会临时将其开启，并且是借助 来达成环境隔离的。

#数据库Java调试# #性能调优# #SQL实战层面的优化# #调试相关窍诀妙法#。

如有侵权请联系删除！