告别MyBatis的‘?‘占位符：用p6spy 3.9.1在Spring Boot里打印可直接执行的SQL（附自定义日志格式）
告别MyBatis的'?'占位符：用p6spy 3.9.1在Spring Boot里打印可直接执行的SQL（附自定义日志格式）
调试SQL语句是Java开发中的日常操作，但MyBatis和JPA等ORM框架输出的预编译SQL总带着恼人的'?'占位符。每次排查问题时，开发者不得不手动替换参数，既浪费时间又容易出错。p6spy 3.9.1正是为解决这一痛点而生——它能将晦涩的预编译语句转换为可直接在数据库客户端执行的完整SQL。
1. 为什么需要SQL语句可视化？
在Spring Boot项目中，ORM框架生成的SQL日志通常是这样的：
SELECT * FROM users WHERE id = ? AND status = ?这种输出对调试极不友好：
- 无法直接执行：需要手动替换占位符
- 缺少关键信息：执行时间、连接ID等调试要素缺失
- 上下文割裂：难以关联同一事务中的多条SQL
p6spy通过数据源代理技术，在SQL到达真实数据库前进行拦截和格式化。相比原生HikariCP或Druid的监控功能，它的优势在于：
- 完整的参数替换：自动将
?替换为实际值 - 执行耗时统计：精确到毫秒的性能数据
- 多输出渠道：控制台、文件或Slf4j日志系统
实际项目中，使用p6spy后SQL日志变为：
[2023-08-20 14:30:45] --- | took 12ms | statement | connection 5 SELECT * FROM users WHERE id = 123 AND status = 'ACTIVE';
2. Spring Boot集成实战
2.1 依赖配置
首先在pom.xml中添加p6spy依赖（注意排除可能冲突的旧版本）：
<dependency> <groupId>p6spy</groupId> <artifactId>p6spy</artifactId> <version>3.9.1</version> </dependency>2.2 数据源改造
修改application.yml中的数据库配置：
spring: datasource: driver-class-name: com.p6spy.engine.spy.P6SpyDriver url: jdbc:p6spy:mysql://localhost:3306/db_name # 原始配置需保留在spy.properties中2.3 核心配置文件
在resources/spy.properties中配置基础参数：
# 启用SQL格式化模块 module.log=com.p6spy.engine.logging.P6LogFactory # 使用控制台输出 appender=com.p6spy.engine.spy.appender.StdoutLogger # 真实数据库驱动 driverlist=com.mysql.cj.jdbc.Driver # 慢SQL阈值(秒) outagedetection=true outagedetectioninterval=23. 高级格式化技巧
3.1 内置格式化方案
p6spy提供两种预置格式：
- SingleLineFormat（默认）：基础单行输出
- CustomLineFormat：可配置的模板化输出
推荐使用CustomLineFormat并配置：
logMessageFormat=com.p6spy.engine.spy.appender.CustomLineFormat customLogMessageFormat=%(currentTime) | 耗时 %(executionTime)ms | 连接 %(connectionId) | 语句：%(sql)3.2 自定义格式化器
创建自定义格式化类实现更复杂的日志输出：
public class CustomSqlFormatter implements MessageFormattingStrategy { @Override public String formatMessage(int connectionId, String now, long elapsed, String category, String prepared, String sql) { return String.format("\n[%s] [%dms] %s\n%s;", LocalDateTime.now().format(DateTimeFormatter.ISO_LOCAL_TIME), elapsed, category, sql.replaceAll("\\s+", " ").trim()); } }然后在配置中指定：
logMessageFormat=com.your.package.CustomSqlFormatter4. 生产环境最佳实践
4.1 性能优化配置
# 关闭不必要的信息 excludecategories=info,debug,resultset,batch # 仅记录超过100ms的SQL executionThreshold=100 # 异步日志输出（需配合Log4j2） appender=com.p6spy.engine.spy.appender.AsyncLogger4.2 多环境策略
建议通过Spring Profile实现差异化配置：
# application-dev.yml p6spy: enabled: true log-level: debug # application-prod.yml p6spy: enabled: false4.3 与Logback集成
对于使用SLF4J的项目，推荐配置：
appender=com.p6spy.engine.spy.appender.Slf4JLogger logMessageFormat=com.p6spy.engine.spy.appender.CustomLineFormat customLogMessageFormat=[%(executionTime)ms] %(sqlSingleLine)配合logback-spring.xml实现SQL日志单独归档：
<appender name="SQL_APPENDER" class="ch.qos.logback.core.rolling.RollingFileAppender"> <file>logs/sql.log</file> <filter class="ch.qos.logback.classic.filter.ThresholdFilter"> <level>DEBUG</level> </filter> </appender> <logger name="p6spy" level="DEBUG" additivity="false"> <appender-ref ref="SQL_APPENDER"/> </logger>5. 疑难问题排查
问题1：SQL日志没有参数替换
- 检查
driverlist是否配置了真实驱动 - 确认URL前缀为
jdbc:p6spy:
问题2：性能明显下降
- 启用
executionThreshold过滤短耗时SQL - 考虑使用
AsyncLogger异步输出
问题3：与HikariCP兼容问题
# 在spy.properties中添加 deregisterdrivers=true realdatasourceclass=com.zaxxer.hikari.HikariDataSource在最近的一个电商项目中，我们通过p6spy发现了多个N+1查询问题。其中一个商品列表接口的SQL调用次数从原来的57次降到了3次，响应时间从1200ms优化到200ms。关键就在于能直观看到完整SQL执行序列。