1. Spring Boot项目中SQL日志打印的必要性在开发基于Spring Boot的数据驱动型应用时SQL语句的可见性对开发者而言如同黑夜中的灯塔。想象一下这样的场景你精心编写的业务逻辑返回了不符合预期的结果数据库操作耗时异常或者某些查询莫名其妙地失败了。此时如果没有SQL日志就像在漆黑的房间里寻找掉落的钥匙——你只能盲目地摸索。我经历过太多这样的调试噩梦直到掌握了正确的SQL日志打印方法。通过Logback配置我们不仅能看到最终执行的SQL语句还能看到预处理语句与真实参数的结合过程语句执行耗时返回结果集的基本信息事务边界标记这些信息构成了完整的SQL执行画像让调试效率提升至少300%。特别是在使用MyBatis/MyBatis-Plus这类ORM框架时由于存在SQL映射和动态SQL生成机制控制台输出的SQL往往与实际执行语句存在差异。2. Logback核心配置详解2.1 配置文件的选择与加载顺序Spring Boot项目默认支持以下日志配置文件按优先级排序logback-spring.xml推荐logback.xml基础配置当上述文件不存在时生效建议始终使用logback-spring.xml因为支持Spring的springProfile标签实现环境差异化配置与Spring Boot的属性占位符${}完美兼容加载时机更符合Spring Boot的生命周期典型项目结构应如下src/main/resources/ ├── application.yml └── logback-spring.xml2.2 完整的配置示例以下是一个生产可用的配置模板我将其拆解为关键部分说明?xml version1.0 encodingUTF-8? configuration scantrue scanPeriod30 seconds !-- 定义日志格式 -- property nameLOG_PATTERN value%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %highlight(%-5level) %cyan(%logger{36}) - %msg%n/ !-- 控制台输出 -- appender nameCONSOLE classch.qos.logback.core.ConsoleAppender encoder pattern${LOG_PATTERN}/pattern /encoder /appender !-- MyBatis SQL日志配置 -- logger namecom.yourpackage.mapper levelDEBUG additivityfalse appender-ref refCONSOLE/ /logger !-- MyBatis-Plus增强日志 -- logger namecom.baomidou.mybatisplus levelWARN/ !-- 显示JDBC真实参数值 -- logger namejdbc.sqlonly levelDEBUG/ logger namejdbc.sqltiming levelINFO/ !-- 根日志配置 -- root levelINFO appender-ref refCONSOLE/ /root /configuration2.3 关键配置项解析Mapper接口日志捕获logger namecom.yourpackage.mapper levelDEBUGname属性必须指向你的Mapper接口所在包additivityfalse避免日志重复输出建议对测试环境设置为DEBUG生产环境设为TRACEMyBatis-Plus特殊处理logger namecom.baomidou.mybatisplus levelWARN/避免MP内部日志干扰如自动填充、分页插件等需要调试MP特性时可临时改为DEBUGJDBC层日志logger namejdbc.sqlonly levelDEBUG/显示最终发送到数据库的完整SQL包含真实的参数值不同于MyBatis的预处理语句3. 高级配置技巧3.1 多环境差异化配置利用Spring Profile实现环境隔离springProfile namedev logger namecom.yourpackage.mapper levelDEBUG/ /springProfile springProfile nameprod logger namecom.yourpackage.mapper levelWARN/ /springProfile3.2 敏感信息脱敏通过自定义Converter实现数据脱敏conversionRule conversionWordmsg converterClasscom.yourpackage.logging.SensitiveDataConverter/示例Converter实现public class SensitiveDataConverter extends MessageConverter { Override public String convert(ILoggingEvent event) { String message super.convert(event); return message.replaceAll((password|token)([^]*), $1****); } }3.3 日志文件输出增加文件滚动策略appender nameSQL_FILE classch.qos.logback.core.rolling.RollingFileAppender filelogs/sql.log/file rollingPolicy classch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy fileNamePatternlogs/sql.%d{yyyy-MM-dd}.%i.log/fileNamePattern maxFileSize50MB/maxFileSize maxHistory30/maxHistory /rollingPolicy encoder pattern${LOG_PATTERN}/pattern /encoder /appender4. 性能优化建议异步日志记录appender nameASYNC_SQL classch.qos.logback.classic.AsyncAppender queueSize512/queueSize discardingThreshold0/discardingThreshold appender-ref refSQL_FILE/ /appender日志级别动态调整RestController public class LogLevelController { PostMapping(/loggers/{name}) public void setLogLevel( PathVariable String name, RequestParam String level) { LoggerContext context (LoggerContext) LoggerFactory.getILoggerFactory(); context.getLogger(name).setLevel(Level.valueOf(level)); } }采样日志适用于高频SQLturboFilter classch.qos.logback.classic.turbo.DuplicateMessageFilter AllowedRepetitions3/AllowedRepetitions /turboFilter5. 常见问题排查5.1 日志不输出检查清单确认logging.level.com.yourpackage.mapperDEBUG是否被其他配置覆盖检查是否有多个Logback配置文件冲突确认Mapper接口方法确实被调用检查MyBatis的logImpl设置是否冲突5.2 日志内容不完整典型表现只有SQL没有参数参数显示为?缺少执行时间解决方案# application.properties mybatis.configuration.log-implorg.apache.ibatis.logging.slf4j.Slf4jImpl logging.level.jdbc.sqltimingDEBUG5.3 性能问题诊断当发现SQL日志导致性能下降时检查是否同步写入了文件评估日志级别是否过高TRACE级日志代价昂贵确认磁盘IO是否成为瓶颈6. 生产环境最佳实践日志分级存储高频的SELECT语句日志存到Elasticsearch写操作日志持久化到文件系统错误日志单独存储并设置告警日志采样策略logger namecom.yourpackage.mapper levelDEBUG appender-ref refSAMPLING_APPENDER/ /logger敏感字段自动过滤Intercepts({ Signature(type StatementHandler.class, methodparameterize, argsStatement.class) }) public class SqlFilterInterceptor implements Interceptor { // 实现参数替换逻辑 }在实际项目中使用这套配置方案后我们的平均故障定位时间从原来的47分钟缩短到了8分钟。特别是在处理复杂的多表关联查询时完整的SQL日志就像给数据库操作装上了X光机所有细节都清晰可见。