在数据库开发中，你是否经常为"这个SQL到底是怎么执行的"而头疼？P6Spy通过拦截数据库操作，将SQL执行过程透明化，是调试数据库交互的利器。本文将带你全面掌握P6Spy的使用技巧！

目录

一、P6Spy是什么？

二、为什么需要SQL监控？

三、Spring Boot集成实战（3分钟搞定）

1. 添加依赖

2. 修改数据源配置

3. 创建spy.properties

四、核心配置详解

1. 日志输出目标

2. 日志格式定制

3. 过滤器配置

五、高级应用：自定义监控策略

1. 敏感数据脱敏

2. 慢SQL告警

六、输出效果展示

七、生产环境最佳实践

八、同类工具对比

九、常见问题排查

十、总结：P6Spy的核心价值

---

一、P6Spy是什么？

P6Spy是一个开源的数据库监控框架，通过动态代理JDBC驱动实现：

• 实时捕获所有SQL语句

• 记录SQL执行时间

• 暴露预编译SQL参数值

• 支持多种日志输出格式

二、为什么需要SQL监控？

场景	传统方式痛点	P6Spy解决方案
查看完整SQL	预编译语句显示?占位符	显示真实参数值
性能优化	难以定位慢查询	精确记录执行时间
多数据源调试	需要切换日志配置	统一监控所有数据源
生产环境问题复现	无法获取生产环境SQL	安全记录生产SQL日志

三、Spring Boot集成实战（3分钟搞定）

1. 添加依赖

<dependency>
    <groupId>p6spy</groupId>
    <artifactId>p6spy</artifactId>
    <version>3.9.1</version>
</dependency>

2. 修改数据源配置

# 原配置
spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# 修改为
spring.datasource.url=jdbc:p6spy:mysql://localhost:3306/test
spring.datasource.driver-class-name=com.p6spy.engine.spy.P6SpyDriver

3. 创建spy.properties

# 输出目标（控制台/文件）
appender=com.p6spy.engine.spy.appender.StdoutLogger

# SQL格式化配置
logMessageFormat=com.p6spy.engine.spy.appender.CustomLineFormat
customLogMessageFormat=%(currentTime) | SQL耗时: %(executionTime)ms | 连接ID: %(connectionId) | %(sql)

四、核心配置详解

1. 日志输出目标

# 控制台输出（默认）
appender=com.p6spy.engine.spy.appender.StdoutLogger

# 文件输出（每天滚动）
appender=com.p6spy.engine.spy.appender.FileLogger
logfile=spy.log
logfileformat=spy-%d{yyyyMMdd}.log

2. 日志格式定制

# 自定义格式（支持变量）
customLogMessageFormat=
    \n---[ SQL %(executionTime)ms ]-----------------\n
    %(sql) \n
    ---[ 参数: %(parameters) ]\n

# 包含的数据库操作类型（默认全部）
outagedetection=true
outagedetectioninterval=30

3. 过滤器配置

# 排除特定SQL（如健康检查）
exclude=select 1,select @@version

# 包含特定表操作
include=user,order,product

五、高级应用：自定义监控策略

1. 敏感数据脱敏

创建自定义MessageFormat类：

public class SecureFormat extends CustomLineFormat {
    @Override
    public String formatMessage(...) {
        String sql = super.formatMessage(...);
        return sql.replaceAll("password='.*?'", "password='***'");
    }
}

配置文件中设置：

logMessageFormat=com.example.SecureFormat

2. 慢SQL告警

properties

# 慢查询阈值（毫秒）
executionThreshold=300

# 触发告警处理类
executionListener=com.example.SlowSqlAlertListener

告警处理类示例：

public class SlowSqlAlertListener implements P6LogQuery {
    @Override
    public void logElapsed(int elapsed, String sql) {
        if(elapsed > 300) {
            // 发送邮件/钉钉告警
        }
    }
}

六、输出效果展示

2023-08-20 14:30:22 | SQL耗时: 42ms | 连接ID: 12345
SELECT * FROM users 
WHERE email = 'test@example.com' 
AND status = 1

2023-08-20 14:31:15 | SQL耗时: 312ms | 连接ID: 12346
UPDATE orders SET amount = 199.99 
WHERE order_id = 10086

七、生产环境最佳实践

1. 安全防护

   # 启用SQL脱敏
   filter=com.example.SecureFilter
   # 禁止记录DELETE操作
   exclude=DELETE

2. 性能优化配置

   # 关闭自动刷新（提升性能）
   autoflush=false
   # 采样率（大流量场景）
   samplingRate=0.2

3. 日志分离策略

   # 按数据源分离日志
   appender=com.p6spy.engine.spy.appender.RoutingFileAppender
   router=com.example.DatasourceRouter

八、同类工具对比

特性	P6Spy	Log4jdbc	Druid监控
无需代码修改	✅	✅	❌（需改数据源）
显示完整SQL	✅	✅	✅
执行时间监控	✅	✅	✅
连接池监控	❌	❌	✅
可视化界面	❌	❌	✅

选型建议：

• 快速SQL调试 → P6Spy

• 连接池深度监控 → Druid

• 遗留项目集成 → Log4jdbc

九、常见问题排查

问题1：SQL日志没有输出
✅ 检查步骤：

1. 确认spy.properties在classpath根目录

2. 检查JDBC URL前缀是否为jdbc:p6spy:

3. 验证驱动类是否为P6SpyDriver

问题2：显示原生预编译语句
✅ 解决方案：

# 启用参数替换
deregisterdrivers=true
useprefix=true

问题3：性能明显下降
✅ 优化方案：

# 关闭堆栈跟踪（提升性能）
stacktrace=false
# 排除简单查询
exclude=SELECT 1,SELECT @@VERSION

十、总结：P6Spy的核心价值

1. 调试效率提升

   • 真实参数值即时可见

   • 执行时间精确到毫秒

2. 零侵入集成

   • 仅修改配置即可启用

   • 无需代码重构

3. 灵活扩展

   • 自定义日志格式

   • 慢SQL告警钩子

   • 敏感数据过滤