控制SQL日志輸出，屏蔽結(jié)果集刷屏)
1. 項(xiàng)目概述精準(zhǔn)控制MyBatis-Plus的日志輸出在基于MyBatis-Plus進(jìn)行企業(yè)級(jí)應(yīng)用開發(fā)時(shí)日志輸出是一個(gè)既基礎(chǔ)又關(guān)鍵的環(huán)節(jié)。尤其是在調(diào)試復(fù)雜SQL、排查數(shù)據(jù)問題或者進(jìn)行性能分析時(shí)我們常常需要查看框架執(zhí)行的SQL語(yǔ)句。然而默認(rèn)情況下MyBatis-Plus或底層的MyBatis的日志輸出可能會(huì)將完整的SQL語(yǔ)句、參數(shù)以及龐大的結(jié)果集一股腦地打印到控制臺(tái)或日志文件中。想象一下當(dāng)你執(zhí)行一個(gè)SELECT * FROM large_table查詢返回了上千條記錄控制臺(tái)瞬間被刷屏不僅難以定位到真正關(guān)心的SQL文本還可能因?yàn)檩敵鲞^多內(nèi)容而拖慢應(yīng)用性能甚至在某些日志量計(jì)費(fèi)的云服務(wù)場(chǎng)景下造成不必要的成本。因此實(shí)現(xiàn)“僅打印SQL不打印Result結(jié)果數(shù)據(jù)”的需求就從一個(gè)簡(jiǎn)單的配置問題上升為關(guān)乎開發(fā)效率、系統(tǒng)性能和運(yùn)維成本的實(shí)際工程問題。這個(gè)需求的核心在于對(duì)MyBatis日志系統(tǒng)的精細(xì)化控制。MyBatis-Plus作為MyBatis的增強(qiáng)工具其日志行為本質(zhì)上繼承并擴(kuò)展了MyBatis的日志體系。MyBatis通過其內(nèi)置的日志工廠適配了市面上主流的日志框架如SLF4JLogback、Log4j2、JUL等。當(dāng)我們?cè)O(shè)置mybatis-plus.configuration.log-impl或通過其他方式開啟日志后框架會(huì)為每個(gè)Mapper接口或命名空間創(chuàng)建一個(gè)日志記錄器并在執(zhí)行SQL的不同階段準(zhǔn)備語(yǔ)句、設(shè)置參數(shù)、執(zhí)行查詢、處理結(jié)果輸出不同級(jí)別的日志。我們想要攔截的正是那個(gè)處理結(jié)果集并打印出所有行數(shù)據(jù)的階段。實(shí)現(xiàn)這個(gè)目標(biāo)通常有幾種不同粒度的思路最粗粒度的是全局日志級(jí)別控制但這可能把其他有用的調(diào)試信息也關(guān)掉了最細(xì)粒度的是自定義日志實(shí)現(xiàn)完全接管日志輸出格式但實(shí)現(xiàn)成本較高而最實(shí)用、最常用的則是利用MyBatis/MyBatis-Plus提供的現(xiàn)有配置或擴(kuò)展點(diǎn)對(duì)特定類型SELECT查詢或特定Mapper的日志輸出行為進(jìn)行外科手術(shù)式的精準(zhǔn)調(diào)整。接下來(lái)我們就從設(shè)計(jì)思路開始拆解幾種主流方案并深入實(shí)操細(xì)節(jié)和避坑指南。2. 核心思路與方案選型解析要實(shí)現(xiàn)“只打印SQL不打印結(jié)果”我們需要先理解MyBatis日志輸出的完整鏈條。一次查詢的日志輸出通常包含以下幾個(gè)部分Preparing: 打印即將執(zhí)行的SQL語(yǔ)句其中參數(shù)占位符為?。Parameters: 打印SQL語(yǔ)句中每個(gè)占位符對(duì)應(yīng)的實(shí)際參數(shù)值。Total: 打印該查詢執(zhí)行所耗費(fèi)的總時(shí)間如果配置了。Result Set: 打印查詢返回的結(jié)果集每行數(shù)據(jù)都會(huì)以類似{id1, name‘John’, …}的格式輸出。這正是我們想要屏蔽的部分。因此我們的目標(biāo)就是在日志輸出鏈條中攔截或禁用“Result Set”部分的打印同時(shí)保留前三個(gè)部分。這通常需要在日志框架的配置層面或MyBatis的日志實(shí)現(xiàn)層面進(jìn)行操作。2.1 方案一調(diào)整日志框架的Logger級(jí)別最直接但可能誤傷這是最直觀的想法。MyBatis的日志輸出最終是通過我們項(xiàng)目使用的日志框架如Logback、Log4j2來(lái)輸出的。每個(gè)Mapper接口在日志框架中對(duì)應(yīng)一個(gè)Logger其名稱通常為Mapper接口的全限定名如com.example.mapper.UserMapper。MyBatis在執(zhí)行不同階段會(huì)使用不同的日志級(jí)別DEBUG, TRACE等進(jìn)行記錄。通常“Preparing”和“Parameters”是在DEBUG級(jí)別輸出的而“Result Set”的詳細(xì)內(nèi)容往往是在更低的TRACE級(jí)別輸出的。操作思路將特定Mapper或全局的日志級(jí)別設(shè)置為DEBUG而非TRACE。優(yōu)點(diǎn)配置簡(jiǎn)單無(wú)需修改代碼通過logback-spring.xml或log4j2.xml即可完成。缺點(diǎn)粒度較粗。如果其他組件或MyBatis本身有在TRACE級(jí)別輸出的有用信息例如更詳細(xì)的連接池狀態(tài)、緩存操作細(xì)節(jié)這些信息也會(huì)被一并屏蔽。這屬于一種“范圍誤傷”。適用場(chǎng)景當(dāng)你非常確定只需要DEBUG級(jí)別的SQL和參數(shù)信息且不關(guān)心任何TRACE信息時(shí)可以采用此方案。它適合作為快速驗(yàn)證或臨時(shí)調(diào)試的手段。2.2 方案二配置MyBatis的log-impl并自定義日志實(shí)現(xiàn)最靈活但較復(fù)雜MyBatis允許我們指定一個(gè)自定義的日志實(shí)現(xiàn)類。我們可以繼承官方提供的某個(gè)日志適配器如Slf4jImpl然后重寫其中打印結(jié)果集的方法。操作思路創(chuàng)建一個(gè)自定義類繼承自org.apache.ibatis.logging.slf4j.Slf4jImpl假設(shè)使用SLF4J。重寫debug方法或相關(guān)的結(jié)果集打印方法。在MyBatis的日志調(diào)用鏈中結(jié)果集的打印最終會(huì)調(diào)用日志實(shí)例的某個(gè)輸出方法。我們需要找到這個(gè)點(diǎn)并進(jìn)行過濾。在MyBatis配置中將log-impl指向我們這個(gè)自定義類。優(yōu)點(diǎn)控制力極強(qiáng)可以精確到只過濾結(jié)果集日志不影響其他TRACE或DEBUG信息。理論上最干凈。缺點(diǎn)實(shí)現(xiàn)相對(duì)復(fù)雜需要深入理解MyBatis內(nèi)部日志調(diào)用機(jī)制。并且不同版本的MyBatis其日志類的內(nèi)部方法可能有所不同存在一定的兼容性維護(hù)成本。適用場(chǎng)景對(duì)日志輸出有極其精確的控制需求且項(xiàng)目架構(gòu)允許進(jìn)行此類底層定制。通常在中大型、對(duì)可觀測(cè)性要求極高的項(xiàng)目中會(huì)考慮。2.3 方案三使用MyBatis-Plus的PerformanceInterceptor或自定義插件推薦平衡方案這是我個(gè)人最推薦也是實(shí)踐中使用最廣泛的方案。MyBatis-Plus提供了一些內(nèi)置的插件其中PerformanceInterceptor性能分析攔截器就具備輸出SQL和執(zhí)行時(shí)間的功能。更重要的是我們可以通過自定義插件Interceptor來(lái)攔截StatementHandler的query方法在執(zhí)行完畢后手動(dòng)輸出我們想要的日志SQL和參數(shù)而完全跳過框架默認(rèn)的結(jié)果集打印流程。操作思路關(guān)閉MyBatis自帶的詳細(xì)日志將日志級(jí)別設(shè)為WARN或以上或者不配置log-impl從根本上阻止其輸出結(jié)果集。創(chuàng)建一個(gè)實(shí)現(xiàn)MyBatisInterceptor接口的自定義插件。在插件的intercept方法中攔截StatementHandler的query或update方法。在方法執(zhí)行前后獲取BoundSql對(duì)象從中解析出SQL語(yǔ)句和參數(shù)然后使用我們自己的日志工具如log.debug按我們喜歡的格式進(jìn)行打印。將這個(gè)插件配置到MyBatis的插件鏈中。優(yōu)點(diǎn)完全可控日志格式、內(nèi)容、級(jí)別都由我們自己決定?？梢暂p松實(shí)現(xiàn)“只打印SQL和參數(shù)”。功能強(qiáng)大插件機(jī)制是MyBatis的核心擴(kuò)展點(diǎn)我們可以在同一插件中輕松集成性能監(jiān)控、SQL格式化、慢查詢告警等其他功能。無(wú)侵入性不需要修改MyBatis的日志實(shí)現(xiàn)類通過標(biāo)準(zhǔn)擴(kuò)展點(diǎn)實(shí)現(xiàn)更符合框架設(shè)計(jì)哲學(xué)。缺點(diǎn)需要編寫少量代碼并理解MyBatis插件的基本工作原理。適用場(chǎng)景絕大多數(shù)生產(chǎn)環(huán)境和需要精細(xì)化日志管理的開發(fā)環(huán)境。它提供了性能、靈活性和可控性的最佳平衡。注意在MyBatis-Plus 3.4.0及以上版本官方推薦使用MybatisPlusInterceptor這個(gè)統(tǒng)一攔截器并將各種功能以“內(nèi)部攔截器”的方式添加進(jìn)去。但對(duì)于自定義日志打印我們依然可以創(chuàng)建獨(dú)立的傳統(tǒng)插件并添加到這個(gè)統(tǒng)一攔截器之前或之后邏輯是相通的。綜合來(lái)看方案三自定義插件因其強(qiáng)大的靈活性和可控性成為解決本需求的首選。接下來(lái)我們將深入方案三的實(shí)操細(xì)節(jié)。3. 通過自定義插件實(shí)現(xiàn)精準(zhǔn)日志控制我們將一步步實(shí)現(xiàn)一個(gè)自定義的MyBatis插件用于在控制臺(tái)或日志文件中打印SQL語(yǔ)句和參數(shù)同時(shí)避免輸出結(jié)果集。3.1 環(huán)境準(zhǔn)備與依賴確認(rèn)首先確保你的項(xiàng)目是基于Spring Boot并集成了MyBatis-Plus。一個(gè)典型的pom.xml依賴配置如下dependencies !-- Spring Boot Starter -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis-Plus Starter -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version !-- 請(qǐng)使用最新穩(wěn)定版 -- /dependency !-- 數(shù)據(jù)庫(kù)驅(qū)動(dòng)例如MySQL -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency !-- 日志框架這里使用Spring Boot默認(rèn)的Logback -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-logging/artifactId /dependency /dependencies關(guān)鍵點(diǎn)在于mybatis-plus-boot-starter它已經(jīng)包含了MyBatis的所有必要依賴。我們不需要額外引入MyBatis的核心包。3.2 關(guān)閉MyBatis原生詳細(xì)日志為了避免我們的自定義插件和MyBatis原生日志同時(shí)輸出造成重復(fù)和混亂第一步是先關(guān)閉MyBatis原生的DEBUG/TRACE級(jí)別日志。在application.yml或application.properties中進(jìn)行配置application.yml 示例# 關(guān)閉MyBatis原生日志實(shí)現(xiàn)防止其輸出結(jié)果集 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 可以設(shè)置為一個(gè)不輸出的實(shí)現(xiàn)或者不配置。這里設(shè)為StdOutImpl僅作示例實(shí)際我們會(huì)用插件控制。 # 更推薦的做法是通過全局日志級(jí)別控制 logging: level: # 將你的Mapper接口所在包的日志級(jí)別設(shè)為WARN或ERROR關(guān)閉其DEBUG/TRACE輸出 com.yourcompany.yourproject.mapper: WARN # 將MyBatis核心包的日志級(jí)別也調(diào)高 org.apache.ibatis: WARN java.sql: WARN # 也可以關(guān)閉JDBC的日志通過將Mapper包和MyBatis核心包的日志級(jí)別設(shè)為WARN我們有效地禁用了它們DEBUG和TRACE級(jí)別的輸出其中就包含了我們不想要的結(jié)果集打印。3.3 創(chuàng)建自定義SQL日志打印插件現(xiàn)在我們來(lái)創(chuàng)建核心的自定義插件。這個(gè)插件將攔截所有執(zhí)行的SQL語(yǔ)句。package com.yourcompany.yourproject.plugin; import lombok.extern.slf4j.Slf4j; import org.apache.ibatis.executor.statement.StatementHandler; import org.apache.ibatis.mapping.BoundSql; import org.apache.ibatis.mapping.ParameterMapping; import org.apache.ibatis.plugin.*; import org.apache.ibatis.reflection.MetaObject; import org.apache.ibatis.reflection.SystemMetaObject; import org.apache.ibatis.session.Configuration; import org.apache.ibatis.type.TypeHandlerRegistry; import org.springframework.stereotype.Component; import java.lang.reflect.Method; import java.sql.Statement; import java.util.List; import java.util.Properties; /** * 自定義SQL日志打印插件 * 攔截StatementHandler的prepare和parameterize方法打印SQL和參數(shù) */ Intercepts({ Signature(type StatementHandler.class, method prepare, args {java.sql.Connection.class, Integer.class}), Signature(type StatementHandler.class, method parameterize, args {Statement.class}) }) Component Slf4j // 使用Lombok的Slf4j注解確保插件使用項(xiàng)目統(tǒng)一的日志框架 public class SqlLoggerInterceptor implements Interceptor { Override public Object intercept(Invocation invocation) throws Throwable { // 1. 獲取被攔截的目標(biāo)對(duì)象 StatementHandler statementHandler (StatementHandler) invocation.getTarget(); MetaObject metaObject SystemMetaObject.forObject(statementHandler); // 2. 獲取BoundSql它包含了SQL語(yǔ)句和參數(shù)映射信息 BoundSql boundSql statementHandler.getBoundSql(); Configuration configuration (Configuration) metaObject.getValue(delegate.configuration); // 3. 獲取方法名區(qū)分是prepare階段還是parameterize階段 Method method invocation.getMethod(); String methodName method.getName(); Object returnValue null; if (prepare.equals(methodName)) { // prepare階段可以獲取到原始的帶占位符的SQL String rawSql boundSql.getSql(); log.debug( Preparing: {}, formatSql(rawSql)); } else if (parameterize.equals(methodName)) { // parameterize階段參數(shù)已設(shè)置可以獲取到完整的帶參數(shù)的SQL // 注意直接獲取到的sql可能還是帶?的我們需要自己拼接參數(shù) String sql boundSql.getSql(); Object parameterObject boundSql.getParameterObject(); ListParameterMapping parameterMappings boundSql.getParameterMappings(); // 格式化SQL將?替換為實(shí)際參數(shù)值 String formattedSql formatSqlWithParameters(sql, parameterObject, parameterMappings, configuration); log.debug( Parameters: {}, formattedSql); // 也可以選擇在這里打印最終SQL但注意參數(shù)可能包含敏感信息 // log.debug( Executing SQL: {}, formatFinalSql(sql, parameterObject, parameterMappings, configuration)); } // 4. 繼續(xù)執(zhí)行原方法鏈 returnValue invocation.proceed(); // 5. 如果需要可以在執(zhí)行后打印影響行數(shù)或時(shí)間需額外攔截update/query方法 // 本例專注于打印SQL和參數(shù)結(jié)果集打印已被我們忽略 return returnValue; } /** * 格式化原始SQL美化換行等 */ private String formatSql(String sql) { return sql.replaceAll([\\s], ).trim(); } /** * 將SQL中的占位符?替換為實(shí)際的參數(shù)值用于DEBUG查看 * 注意此方法僅用于日志輸出不能用于實(shí)際執(zhí)行且需處理參數(shù)類型轉(zhuǎn)換。 */ private String formatSqlWithParameters(String sql, Object parameterObject, ListParameterMapping parameterMappings, Configuration configuration) { if (parameterMappings null || parameterMappings.isEmpty() || parameterObject null) { return sql; } TypeHandlerRegistry typeHandlerRegistry configuration.getTypeHandlerRegistry(); StringBuilder sqlBuilder new StringBuilder(sql); // 這里是一個(gè)簡(jiǎn)化的實(shí)現(xiàn)實(shí)際參數(shù)替換邏輯更復(fù)雜需要考慮多個(gè)參數(shù)、IN列表等。 // 更健壯的做法可以參考MyBatis自帶的ParameterHandler邏輯或者使用第三方工具。 // 此處僅作演示將參數(shù)以JSON格式附在SQL后面而不是替換?。 try { // 使用Fastjson、Jackson或Gson將參數(shù)對(duì)象轉(zhuǎn)換為字符串 // 示例String paramsJson JSON.toJSONString(parameterObject); // 為了簡(jiǎn)單這里直接調(diào)用toString() String paramsStr parameterObject.toString(); // 避免輸出過長(zhǎng)可以截?cái)?if (paramsStr.length() 500) { paramsStr paramsStr.substring(0, 500) ... [truncated]; } return sql -- Params: paramsStr; } catch (Exception e) { return sql -- [Parameter display error]; } } Override public Object plugin(Object target) { // 使用MyBatis提供的Plugin.wrap方法來(lái)創(chuàng)建代理對(duì)象 return Plugin.wrap(target, this); } Override public void setProperties(Properties properties) { // 可以從配置文件中讀取插件屬性此處暫無(wú)需求 } }代碼關(guān)鍵點(diǎn)解析Intercepts 和 Signature這是定義MyBatis插件攔截點(diǎn)的核心注解。我們攔截了StatementHandler接口的兩個(gè)方法prepare準(zhǔn)備語(yǔ)句和parameterize設(shè)置參數(shù)。這是打印SQL和參數(shù)的最佳時(shí)機(jī)。獲取BoundSqlBoundSql對(duì)象是MyBatis中承載一次SQL執(zhí)行所有信息的核心對(duì)象包括SQL文本、參數(shù)對(duì)象、參數(shù)映射列表。區(qū)分階段在prepare階段我們打印出原始的、帶?的SQL語(yǔ)句 Preparing:。在parameterize階段我們嘗試獲取并格式化參數(shù)信息 Parameters:。日志級(jí)別我們使用log.debug()進(jìn)行輸出。這意味著你需要在日志配置中為這個(gè)插件類com.yourcompany.yourproject.plugin.SqlLoggerInterceptor或它的包開啟DEBUG級(jí)別日志才會(huì)被打印出來(lái)。不打印結(jié)果集插件根本沒有攔截結(jié)果集處理的步驟如ResultSetHandler的handleResultSets方法所以自然就不會(huì)打印結(jié)果集。這正是我們想要的效果。3.4 配置與啟用自定義插件在Spring Boot中我們需要將自定義插件注冊(cè)到MyBatis的插件鏈中。由于我們使用了Component注解Spring會(huì)自動(dòng)管理這個(gè)Bean。但是我們需要確保它被添加到MyBatis的配置里。創(chuàng)建一個(gè)配置類package com.yourcompany.yourproject.config; import com.yourcompany.yourproject.plugin.SqlLoggerInterceptor; import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor; import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor; // 分頁(yè)插件示例 import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; Configuration public class MyBatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); // 添加分頁(yè)插件這是MyBatis-Plus的常用插件 interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); // 注意我們的SqlLoggerInterceptor是傳統(tǒng)的Interceptor // 需要單獨(dú)添加到SqlSessionFactory中而不是加到這里。 return interceptor; } /** * 單獨(dú)注冊(cè)我們的自定義SQL日志插件。 * 另一種方式是在SqlLoggerInterceptor類上直接使用Bean注解。 * 這里顯式聲明是為了更清晰地控制。 */ Bean public SqlLoggerInterceptor sqlLoggerInterceptor() { return new SqlLoggerInterceptor(); } }重要提示在Spring Boot MyBatis-Plus環(huán)境中只要插件類被Spring容器管理即加了Component或BeanMyBatis的自動(dòng)配置機(jī)制通常會(huì)自動(dòng)發(fā)現(xiàn)并注冊(cè)所有實(shí)現(xiàn)了Interceptor接口的Bean。所以上面的sqlLoggerInterceptor()Bean方法有時(shí)不是必須的Component注解可能就足夠了。但顯式聲明是一個(gè)好習(xí)慣可以避免因依賴掃描順序?qū)е碌膯栴}。3.5 配置日志輸出級(jí)別最后我們需要在application.yml中配置日志確保我們的插件能輸出日志而其他干擾日志被關(guān)閉。logging: level: # 1. 關(guān)閉MyBatis和JDBC的詳細(xì)日志防止結(jié)果集輸出 org.apache.ibatis: WARN java.sql: WARN java.sql.Connection: WARN java.sql.Statement: WARN java.sql.PreparedStatement: WARN java.sql.ResultSet: WARN # 2. 關(guān)閉你項(xiàng)目Mapper接口的詳細(xì)日志防止和插件輸出重復(fù) com.yourcompany.yourproject.mapper: WARN # 3. 為你自定義的插件類開啟DEBUG日志這樣我們打印的SQL才會(huì)顯示 com.yourcompany.yourproject.plugin.SqlLoggerInterceptor: DEBUG # 4. 如果你想知道插件是否被加載可以將其級(jí)別設(shè)為INFO或DEBUG com.yourcompany.yourproject.plugin: DEBUG pattern: console: %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n這個(gè)配置實(shí)現(xiàn)了精準(zhǔn)控制第1、2步關(guān)閉了所有可能輸出結(jié)果集和冗余SQL信息的源頭。第3步只為我們自定義的插件打開了DEBUG通道讓它能輸出我們精心格式化的“Preparing”和“Parameters”日志。啟動(dòng)你的Spring Boot應(yīng)用執(zhí)行一個(gè)查詢操作你將在控制臺(tái)看到類似如下的輸出并且絕對(duì)不會(huì)出現(xiàn)結(jié)果集數(shù)據(jù)2023-10-27 14:30:25.123 [http-nio-8080-exec-1] DEBUG c.y.y.p.SqlLoggerInterceptor - Preparing: SELECT id, username, email FROM user WHERE age ? 2023-10-27 14:30:25.124 [http-nio-8080-exec-1] DEBUG c.y.y.p.SqlLoggerInterceptor - Parameters: SELECT id, username, email FROM user WHERE age ? -- Params: 184. 高級(jí)優(yōu)化與生產(chǎn)實(shí)踐基礎(chǔ)的插件已經(jīng)能工作但在生產(chǎn)環(huán)境中我們還需要考慮更多細(xì)節(jié)。4.1 優(yōu)化SQL參數(shù)格式化上面的示例中formatSqlWithParameters方法實(shí)現(xiàn)得很簡(jiǎn)單只是將參數(shù)對(duì)象的toString()結(jié)果附在后面。這對(duì)于簡(jiǎn)單類型如Integer, String尚可但對(duì)于復(fù)雜對(duì)象、集合如List用于IN查詢或Map輸出可讀性很差。一個(gè)更專業(yè)的做法是模擬MyBatis內(nèi)置的日志實(shí)現(xiàn)將SQL中的?逐個(gè)替換為格式化的參數(shù)值。這里提供一個(gè)增強(qiáng)版的格式化方法思路private String formatSqlWithParametersEnhanced(String sql, Object parameterObject, ListParameterMapping parameterMappings, Configuration configuration) { if (parameterMappings null || parameterMappings.isEmpty()) { return sql; } TypeHandlerRegistry typeHandlerRegistry configuration.getTypeHandlerRegistry(); StringBuilder formattedSql new StringBuilder(); int index 0; int paramIndex 0; String sqlText sql; // 遍歷SQL字符串找到?并替換 for (ParameterMapping mapping : parameterMappings) { int qIndex sqlText.indexOf(?, index); if (qIndex -1) { break; } formattedSql.append(sqlText, index, qIndex); // 追加?之前的部分 // 獲取參數(shù)值 Object value; String propertyName mapping.getProperty(); if (boundSql.hasAdditionalParameter(propertyName)) { value boundSql.getAdditionalParameter(propertyName); } else if (parameterObject null) { value null; } else if (typeHandlerRegistry.hasTypeHandler(parameterObject.getClass())) { value parameterObject; } else { // 從參數(shù)對(duì)象中獲取屬性值這里簡(jiǎn)化了實(shí)際需處理復(fù)雜對(duì)象圖 MetaObject metaObject configuration.newMetaObject(parameterObject); value metaObject.getValue(propertyName); } // 格式化參數(shù)值用于顯示 formattedSql.append(formatParameterValue(value)); index qIndex 1; paramIndex; } formattedSql.append(sqlText.substring(index)); // 追加剩余部分 return formattedSql.toString(); } private String formatParameterValue(Object value) { if (value null) { return null; } if (value instanceof String || value instanceof Character) { return value.toString().replace(, ) ; } if (value instanceof Date) { return new SimpleDateFormat(yyyy-MM-dd HH:mm:ss).format((Date) value) ; } // 其他類型直接返回字符串形式 return value.toString(); }注意上述增強(qiáng)格式化邏輯較為復(fù)雜且需要處理BoundSql的additionalParameters等細(xì)節(jié)。在實(shí)際項(xiàng)目中如果你需要完美的參數(shù)替換效果可以考慮直接使用MyBatis內(nèi)置的ParameterHandler邏輯或者參考開源項(xiàng)目如p6spy的思路。對(duì)于大多數(shù)調(diào)試場(chǎng)景將參數(shù)以JSON形式附在SQL后面如初始示例已經(jīng)足夠清晰。4.2 集成性能監(jiān)控與慢查詢?nèi)罩炯热晃覀円呀?jīng)有了一個(gè)插件攔截了SQL執(zhí)行很容易就能擴(kuò)展其功能例如添加執(zhí)行時(shí)間計(jì)算實(shí)現(xiàn)慢查詢警告。修改SqlLoggerInterceptor的intercept方法我們主要攔截StatementHandler的query或update方法這需要修改Signature并在方法執(zhí)行前后記錄時(shí)間。更簡(jiǎn)單的方式是我們可以創(chuàng)建一個(gè)獨(dú)立的性能監(jiān)控插件。這里展示如何在一個(gè)插件里集成簡(jiǎn)單計(jì)時(shí)Intercepts({ Signature(type StatementHandler.class, method update, args {Statement.class}), Signature(type StatementHandler.class, method query, args {Statement.class, ResultHandler.class}) }) public class PerformanceAndSqlLoggerInterceptor implements Interceptor { private static final long SLOW_QUERY_THRESHOLD_MS 1000; // 慢查詢閾值1秒 Override public Object intercept(Invocation invocation) throws Throwable { long startTime System.currentTimeMillis(); // ... (這里可以調(diào)用之前的邏輯打印SQL或獨(dú)立打印) ... StatementHandler handler (StatementHandler) invocation.getTarget(); BoundSql boundSql handler.getBoundSql(); String sql boundSql.getSql(); log.debug(Executing SQL: {}, formatSql(sql)); Object result invocation.proceed(); // 執(zhí)行SQL long endTime System.currentTimeMillis(); long cost endTime - startTime; if (cost SLOW_QUERY_THRESHOLD_MS) { log.warn(Slow SQL detected! Cost: {} ms, SQL: {}, cost, formatSql(sql)); } else { log.debug(SQL executed. Cost: {} ms, cost); } // 關(guān)鍵不打印result對(duì)象本身 return result; } // ... plugin, setProperties 方法 ... }這個(gè)插件在查詢/更新執(zhí)行后計(jì)算耗時(shí)并對(duì)慢查詢進(jìn)行WARN級(jí)別的報(bào)警同時(shí)依然不輸出結(jié)果集內(nèi)容。4.3 敏感信息脫敏處理在生產(chǎn)環(huán)境中SQL日志可能包含敏感信息如手機(jī)號(hào)、郵箱、身份證號(hào)等。直接在日志中打印這些數(shù)據(jù)是危險(xiǎn)的。我們需要在插件中對(duì)參數(shù)值進(jìn)行脫敏。可以在formatParameterValue方法中加入脫敏邏輯private String formatParameterValue(Object value) { if (value null) { return null; } String strValue value.toString(); // 簡(jiǎn)單示例對(duì)可能是手機(jī)號(hào)、郵箱的參數(shù)進(jìn)行脫敏這里需要更精確的字段名判斷 // 實(shí)際項(xiàng)目中可以維護(hù)一個(gè)需要脫敏的字段名列表或正則規(guī)則 // 假設(shè)通過某種方式如解析ParameterMapping的property知道當(dāng)前參數(shù)對(duì)應(yīng)字段名 String fieldName getCurrentFieldName(); // 這是一個(gè)需要實(shí)現(xiàn)的方法 if (fieldName ! null (fieldName.contains(phone) || fieldName.contains(mobile))) { // 手機(jī)號(hào)脫敏138****1234 if (strValue.length() 11) { return strValue.substring(0, 3) **** strValue.substring(7) ; } } if (fieldName ! null fieldName.contains(email)) { // 郵箱脫敏a***example.com int atIndex strValue.indexOf(); if (atIndex 1) { return strValue.charAt(0) *** strValue.substring(atIndex) ; } } // ... 其他類型格式化 ... return strValue ; }實(shí)操心得脫敏邏輯的復(fù)雜性取決于你的需求。一種更通用的做法是在插件中不直接進(jìn)行復(fù)雜的脫敏而是將原始SQL和參數(shù)記錄下來(lái)發(fā)送到專門的安全日志處理服務(wù)如ELK棧并配置脫敏管道在存儲(chǔ)和展示前進(jìn)行統(tǒng)一的脫敏處理。這樣業(yè)務(wù)代碼更干凈脫敏規(guī)則也更容易集中管理。5. 常見問題排查與解決方案實(shí)錄在實(shí)際配置和使用過程中你可能會(huì)遇到以下問題5.1 插件不生效沒有日志輸出可能原因及排查步驟插件未正確注冊(cè)確保你的插件類被Spring容器管理有Component或Bean注解并且所在的包在Spring Boot的主應(yīng)用掃描路徑下?？梢酝ㄟ^在插件的構(gòu)造方法或PostConstruct方法中打日志來(lái)驗(yàn)證是否被實(shí)例化。日志級(jí)別配置錯(cuò)誤這是最常見的原因。檢查application.yml中l(wèi)ogging.level下的配置。確保你的插件類如com.yourcompany.yourproject.plugin.SqlLoggerInterceptor的日志級(jí)別是DEBUG或TRACE。同時(shí)確保全局的日志框架如Logback的根級(jí)別沒有覆蓋為ERROR。MyBatis-Plus版本兼容性不同版本的MyBatis-Plus對(duì)插件的自動(dòng)注冊(cè)機(jī)制可能有細(xì)微差別。如果懷疑是此問題可以嘗試在配置類中顯式地將插件添加到SqlSessionFactoryBean中。Bean public SqlSessionFactory sqlSessionFactory(DataSource dataSource, SqlLoggerInterceptor sqlLoggerInterceptor) throws Exception { MybatisSqlSessionFactoryBean factoryBean new MybatisSqlSessionFactoryBean(); factoryBean.setDataSource(dataSource); // 手動(dòng)添加攔截器 factoryBean.setPlugins(new Interceptor[]{sqlLoggerInterceptor}); return factoryBean.getObject(); }多個(gè)插件沖突如果你配置了多個(gè)MyBatis插件如分頁(yè)插件、樂觀鎖插件需要確保它們的執(zhí)行順序不會(huì)導(dǎo)致某個(gè)插件“吃掉”異?；蚋淖儓?zhí)行流程。通常日志插件應(yīng)該放在插件鏈的最外層最先執(zhí)行。5.2 日志輸出重復(fù)SQL被打印兩次可能原因及排查步驟MyBatis原生日志未關(guān)閉你雖然配置了自定義插件但MyBatis原生的log-impl例如StdOutImpl或Slf4jImpl仍然在工作并且其日志級(jí)別也是DEBUG。這會(huì)導(dǎo)致SQL被打印兩次一次來(lái)自你的插件一次來(lái)自MyBatis自身。解決方案確保在application.yml中將mybatis-plus.configuration.log-impl設(shè)置為一個(gè)不輸出的實(shí)現(xiàn)或者不配置使用默認(rèn)的空實(shí)現(xiàn)并且將org.apache.ibatis和java.sql相關(guān)Logger的級(jí)別設(shè)為WARN如上文配置所示。多個(gè)自定義日志插件檢查是否無(wú)意中創(chuàng)建了多個(gè)功能相似的插件或者將插件注冊(cè)了多次。5.3 參數(shù)格式化顯示為null或不正確可能原因及排查步驟參數(shù)對(duì)象為null如果執(zhí)行的SQL沒有參數(shù)parameterObject可能為null。參數(shù)映射復(fù)雜對(duì)于動(dòng)態(tài)SQL如if標(biāo)簽、foreach循環(huán)用于IN查詢或嵌套參數(shù)對(duì)象BoundSql中的parameterMappings和parameterObject結(jié)構(gòu)會(huì)變得復(fù)雜。上面提供的簡(jiǎn)單格式化方法無(wú)法正確處理這些情況。解決方案對(duì)于生產(chǎn)環(huán)境如果對(duì)參數(shù)可讀性要求高建議采用更穩(wěn)健的方案方案A使用第三方SQL打印工具如p6spy。它可以無(wú)縫集成提供非常完善的SQL格式化包含參數(shù)替換并且完全獨(dú)立于MyBatis的日志系統(tǒng)。方案B只打印帶?的SQL和參數(shù)對(duì)象的JSON快照就像我們第一個(gè)簡(jiǎn)單示例那樣。雖然不夠完美但足夠用于大多數(shù)調(diào)試場(chǎng)景且實(shí)現(xiàn)簡(jiǎn)單穩(wěn)定。方案C深入研讀MyBatis源碼實(shí)現(xiàn)一個(gè)能處理所有復(fù)雜情況的參數(shù)提取器。這需要投入較多精力。5.4 性能影響可能原因及排查步驟DEBUG日志開銷即使日志最終不被輸出因?yàn)锳ppender配置判斷日志級(jí)別isDebugEnabled()和拼接參數(shù)字符串尤其是復(fù)雜對(duì)象的JSON序列化本身也有開銷。解決方案在插件的日志輸出前使用if (log.isDebugEnabled())進(jìn)行判斷避免不必要的字符串拼接。在生產(chǎn)環(huán)境中通過日志配置將插件類的日志級(jí)別設(shè)為INFO或WARN徹底關(guān)閉SQL打印功能?？紤]使用異步日志框架如Log4j2的AsyncLogger來(lái)減少I/O阻塞對(duì)業(yè)務(wù)線程的影響。插件本身邏輯復(fù)雜如果插件的intercept方法里做了太多事情如復(fù)雜的脫敏、遠(yuǎn)程調(diào)用等會(huì)影響每個(gè)SQL的執(zhí)行速度。解決方案保持插件邏輯精簡(jiǎn)。將非關(guān)鍵操作如慢查詢統(tǒng)計(jì)的聚合上報(bào)、脫敏字典查詢改為異步或批量處理。我個(gè)人在實(shí)際項(xiàng)目中的體會(huì)是通過自定義插件控制SQL日志輸出是一個(gè)一勞永逸的解決方案。初期搭建需要花費(fèi)一些時(shí)間理解MyBatis的攔截器機(jī)制和日志框架配置但一旦配置成功它帶來(lái)的整潔日志、可控輸出和強(qiáng)大的擴(kuò)展能力如集成慢查詢監(jiān)控會(huì)讓日常開發(fā)和運(yùn)維排查效率大幅提升。最關(guān)鍵的是它完美地解決了“結(jié)果集刷屏”這個(gè)痛點(diǎn)讓日志文件重新變得清晰可讀。在配置過程中務(wù)必記得“關(guān)閉其他只開自己”的日志級(jí)別配置原則這是避免日志混亂的關(guān)鍵。 MyBatis-Plus自定義插件精準(zhǔn)控制SQL日志輸出，屏蔽結(jié)果集刷屏
1. 項(xiàng)目概述精準(zhǔn)控制MyBatis-Plus的日志輸出在基于MyBatis-Plus進(jìn)行企業(yè)級(jí)應(yīng)用開發(fā)時(shí)日志輸出是一個(gè)既基礎(chǔ)又關(guān)鍵的環(huán)節(jié)。尤其是在調(diào)試復(fù)雜SQL、排查數(shù)據(jù)問題或者進(jìn)行性能分析時(shí)我們常常需要查看框架執(zhí)行的SQL語(yǔ)句。然而默認(rèn)情況下MyBatis-Plus或底層的MyBatis的日志輸出可能會(huì)將完整的SQL語(yǔ)句、參數(shù)以及龐大的結(jié)果集一股腦地打印到控制臺(tái)或日志文件中。想象一下當(dāng)你執(zhí)行一個(gè)SELECT * FROM large_table查詢返回了上千條記錄控制臺(tái)瞬間被刷屏不僅難以定位到真正關(guān)心的SQL文本還可能因?yàn)檩敵鲞^多內(nèi)容而拖慢應(yīng)用性能甚至在某些日志量計(jì)費(fèi)的云服務(wù)場(chǎng)景下造成不必要的成本。因此實(shí)現(xiàn)“僅打印SQL不打印Result結(jié)果數(shù)據(jù)”的需求就從一個(gè)簡(jiǎn)單的配置問題上升為關(guān)乎開發(fā)效率、系統(tǒng)性能和運(yùn)維成本的實(shí)際工程問題。這個(gè)需求的核心在于對(duì)MyBatis日志系統(tǒng)的精細(xì)化控制。MyBatis-Plus作為MyBatis的增強(qiáng)工具其日志行為本質(zhì)上繼承并擴(kuò)展了MyBatis的日志體系。MyBatis通過其內(nèi)置的日志工廠適配了市面上主流的日志框架如SLF4JLogback、Log4j2、JUL等。當(dāng)我們?cè)O(shè)置mybatis-plus.configuration.log-impl或通過其他方式開啟日志后框架會(huì)為每個(gè)Mapper接口或命名空間創(chuàng)建一個(gè)日志記錄器并在執(zhí)行SQL的不同階段準(zhǔn)備語(yǔ)句、設(shè)置參數(shù)、執(zhí)行查詢、處理結(jié)果輸出不同級(jí)別的日志。我們想要攔截的正是那個(gè)處理結(jié)果集并打印出所有行數(shù)據(jù)的階段。實(shí)現(xiàn)這個(gè)目標(biāo)通常有幾種不同粒度的思路最粗粒度的是全局日志級(jí)別控制但這可能把其他有用的調(diào)試信息也關(guān)掉了最細(xì)粒度的是自定義日志實(shí)現(xiàn)完全接管日志輸出格式但實(shí)現(xiàn)成本較高而最實(shí)用、最常用的則是利用MyBatis/MyBatis-Plus提供的現(xiàn)有配置或擴(kuò)展點(diǎn)對(duì)特定類型SELECT查詢或特定Mapper的日志輸出行為進(jìn)行外科手術(shù)式的精準(zhǔn)調(diào)整。接下來(lái)我們就從設(shè)計(jì)思路開始拆解幾種主流方案并深入實(shí)操細(xì)節(jié)和避坑指南。2. 核心思路與方案選型解析要實(shí)現(xiàn)“只打印SQL不打印結(jié)果”我們需要先理解MyBatis日志輸出的完整鏈條。一次查詢的日志輸出通常包含以下幾個(gè)部分Preparing: 打印即將執(zhí)行的SQL語(yǔ)句其中參數(shù)占位符為?。Parameters: 打印SQL語(yǔ)句中每個(gè)占位符對(duì)應(yīng)的實(shí)際參數(shù)值。Total: 打印該查詢執(zhí)行所耗費(fèi)的總時(shí)間如果配置了。Result Set: 打印查詢返回的結(jié)果集每行數(shù)據(jù)都會(huì)以類似{id1, name‘John’, …}的格式輸出。這正是我們想要屏蔽的部分。因此我們的目標(biāo)就是在日志輸出鏈條中攔截或禁用“Result Set”部分的打印同時(shí)保留前三個(gè)部分。這通常需要在日志框架的配置層面或MyBatis的日志實(shí)現(xiàn)層面進(jìn)行操作。2.1 方案一調(diào)整日志框架的Logger級(jí)別最直接但可能誤傷這是最直觀的想法。MyBatis的日志輸出最終是通過我們項(xiàng)目使用的日志框架如Logback、Log4j2來(lái)輸出的。每個(gè)Mapper接口在日志框架中對(duì)應(yīng)一個(gè)Logger其名稱通常為Mapper接口的全限定名如com.example.mapper.UserMapper。MyBatis在執(zhí)行不同階段會(huì)使用不同的日志級(jí)別DEBUG, TRACE等進(jìn)行記錄。通常“Preparing”和“Parameters”是在DEBUG級(jí)別輸出的而“Result Set”的詳細(xì)內(nèi)容往往是在更低的TRACE級(jí)別輸出的。操作思路將特定Mapper或全局的日志級(jí)別設(shè)置為DEBUG而非TRACE。優(yōu)點(diǎn)配置簡(jiǎn)單無(wú)需修改代碼通過logback-spring.xml或log4j2.xml即可完成。缺點(diǎn)粒度較粗。如果其他組件或MyBatis本身有在TRACE級(jí)別輸出的有用信息例如更詳細(xì)的連接池狀態(tài)、緩存操作細(xì)節(jié)這些信息也會(huì)被一并屏蔽。這屬于一種“范圍誤傷”。適用場(chǎng)景當(dāng)你非常確定只需要DEBUG級(jí)別的SQL和參數(shù)信息且不關(guān)心任何TRACE信息時(shí)可以采用此方案。它適合作為快速驗(yàn)證或臨時(shí)調(diào)試的手段。2.2 方案二配置MyBatis的log-impl并自定義日志實(shí)現(xiàn)最靈活但較復(fù)雜MyBatis允許我們指定一個(gè)自定義的日志實(shí)現(xiàn)類。我們可以繼承官方提供的某個(gè)日志適配器如Slf4jImpl然后重寫其中打印結(jié)果集的方法。操作思路創(chuàng)建一個(gè)自定義類繼承自org.apache.ibatis.logging.slf4j.Slf4jImpl假設(shè)使用SLF4J。重寫debug方法或相關(guān)的結(jié)果集打印方法。在MyBatis的日志調(diào)用鏈中結(jié)果集的打印最終會(huì)調(diào)用日志實(shí)例的某個(gè)輸出方法。我們需要找到這個(gè)點(diǎn)并進(jìn)行過濾。在MyBatis配置中將log-impl指向我們這個(gè)自定義類。優(yōu)點(diǎn)控制力極強(qiáng)可以精確到只過濾結(jié)果集日志不影響其他TRACE或DEBUG信息。理論上最干凈。缺點(diǎn)實(shí)現(xiàn)相對(duì)復(fù)雜需要深入理解MyBatis內(nèi)部日志調(diào)用機(jī)制。并且不同版本的MyBatis其日志類的內(nèi)部方法可能有所不同存在一定的兼容性維護(hù)成本。適用場(chǎng)景對(duì)日志輸出有極其精確的控制需求且項(xiàng)目架構(gòu)允許進(jìn)行此類底層定制。通常在中大型、對(duì)可觀測(cè)性要求極高的項(xiàng)目中會(huì)考慮。2.3 方案三使用MyBatis-Plus的PerformanceInterceptor或自定義插件推薦平衡方案這是我個(gè)人最推薦也是實(shí)踐中使用最廣泛的方案。MyBatis-Plus提供了一些內(nèi)置的插件其中PerformanceInterceptor性能分析攔截器就具備輸出SQL和執(zhí)行時(shí)間的功能。更重要的是我們可以通過自定義插件Interceptor來(lái)攔截StatementHandler的query方法在執(zhí)行完畢后手動(dòng)輸出我們想要的日志SQL和參數(shù)而完全跳過框架默認(rèn)的結(jié)果集打印流程。操作思路關(guān)閉MyBatis自帶的詳細(xì)日志將日志級(jí)別設(shè)為WARN或以上或者不配置log-impl從根本上阻止其輸出結(jié)果集。創(chuàng)建一個(gè)實(shí)現(xiàn)MyBatisInterceptor接口的自定義插件。在插件的intercept方法中攔截StatementHandler的query或update方法。在方法執(zhí)行前后獲取BoundSql對(duì)象從中解析出SQL語(yǔ)句和參數(shù)然后使用我們自己的日志工具如log.debug按我們喜歡的格式進(jìn)行打印。將這個(gè)插件配置到MyBatis的插件鏈中。優(yōu)點(diǎn)完全可控日志格式、內(nèi)容、級(jí)別都由我們自己決定?？梢暂p松實(shí)現(xiàn)“只打印SQL和參數(shù)”。功能強(qiáng)大插件機(jī)制是MyBatis的核心擴(kuò)展點(diǎn)我們可以在同一插件中輕松集成性能監(jiān)控、SQL格式化、慢查詢告警等其他功能。無(wú)侵入性不需要修改MyBatis的日志實(shí)現(xiàn)類通過標(biāo)準(zhǔn)擴(kuò)展點(diǎn)實(shí)現(xiàn)更符合框架設(shè)計(jì)哲學(xué)。缺點(diǎn)需要編寫少量代碼并理解MyBatis插件的基本工作原理。適用場(chǎng)景絕大多數(shù)生產(chǎn)環(huán)境和需要精細(xì)化日志管理的開發(fā)環(huán)境。它提供了性能、靈活性和可控性的最佳平衡。注意在MyBatis-Plus 3.4.0及以上版本官方推薦使用MybatisPlusInterceptor這個(gè)統(tǒng)一攔截器并將各種功能以“內(nèi)部攔截器”的方式添加進(jìn)去。但對(duì)于自定義日志打印我們依然可以創(chuàng)建獨(dú)立的傳統(tǒng)插件并添加到這個(gè)統(tǒng)一攔截器之前或之后邏輯是相通的。綜合來(lái)看方案三自定義插件因其強(qiáng)大的靈活性和可控性成為解決本需求的首選。接下來(lái)我們將深入方案三的實(shí)操細(xì)節(jié)。3. 通過自定義插件實(shí)現(xiàn)精準(zhǔn)日志控制我們將一步步實(shí)現(xiàn)一個(gè)自定義的MyBatis插件用于在控制臺(tái)或日志文件中打印SQL語(yǔ)句和參數(shù)同時(shí)避免輸出結(jié)果集。3.1 環(huán)境準(zhǔn)備與依賴確認(rèn)首先確保你的項(xiàng)目是基于Spring Boot并集成了MyBatis-Plus。一個(gè)典型的pom.xml依賴配置如下dependencies !-- Spring Boot Starter -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis-Plus Starter -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version !-- 請(qǐng)使用最新穩(wěn)定版 -- /dependency !-- 數(shù)據(jù)庫(kù)驅(qū)動(dòng)例如MySQL -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency !-- 日志框架這里使用Spring Boot默認(rèn)的Logback -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-logging/artifactId /dependency /dependencies關(guān)鍵點(diǎn)在于mybatis-plus-boot-starter它已經(jīng)包含了MyBatis的所有必要依賴。我們不需要額外引入MyBatis的核心包。3.2 關(guān)閉MyBatis原生詳細(xì)日志為了避免我們的自定義插件和MyBatis原生日志同時(shí)輸出造成重復(fù)和混亂第一步是先關(guān)閉MyBatis原生的DEBUG/TRACE級(jí)別日志。在application.yml或application.properties中進(jìn)行配置application.yml 示例# 關(guān)閉MyBatis原生日志實(shí)現(xiàn)防止其輸出結(jié)果集 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 可以設(shè)置為一個(gè)不輸出的實(shí)現(xiàn)或者不配置。這里設(shè)為StdOutImpl僅作示例實(shí)際我們會(huì)用插件控制。 # 更推薦的做法是通過全局日志級(jí)別控制 logging: level: # 將你的Mapper接口所在包的日志級(jí)別設(shè)為WARN或ERROR關(guān)閉其DEBUG/TRACE輸出 com.yourcompany.yourproject.mapper: WARN # 將MyBatis核心包的日志級(jí)別也調(diào)高 org.apache.ibatis: WARN java.sql: WARN # 也可以關(guān)閉JDBC的日志通過將Mapper包和MyBatis核心包的日志級(jí)別設(shè)為WARN我們有效地禁用了它們DEBUG和TRACE級(jí)別的輸出其中就包含了我們不想要的結(jié)果集打印。3.3 創(chuàng)建自定義SQL日志打印插件現(xiàn)在我們來(lái)創(chuàng)建核心的自定義插件。這個(gè)插件將攔截所有執(zhí)行的SQL語(yǔ)句。package com.yourcompany.yourproject.plugin; import lombok.extern.slf4j.Slf4j; import org.apache.ibatis.executor.statement.StatementHandler; import org.apache.ibatis.mapping.BoundSql; import org.apache.ibatis.mapping.ParameterMapping; import org.apache.ibatis.plugin.*; import org.apache.ibatis.reflection.MetaObject; import org.apache.ibatis.reflection.SystemMetaObject; import org.apache.ibatis.session.Configuration; import org.apache.ibatis.type.TypeHandlerRegistry; import org.springframework.stereotype.Component; import java.lang.reflect.Method; import java.sql.Statement; import java.util.List; import java.util.Properties; /** * 自定義SQL日志打印插件 * 攔截StatementHandler的prepare和parameterize方法打印SQL和參數(shù) */ Intercepts({ Signature(type StatementHandler.class, method prepare, args {java.sql.Connection.class, Integer.class}), Signature(type StatementHandler.class, method parameterize, args {Statement.class}) }) Component Slf4j // 使用Lombok的Slf4j注解確保插件使用項(xiàng)目統(tǒng)一的日志框架 public class SqlLoggerInterceptor implements Interceptor { Override public Object intercept(Invocation invocation) throws Throwable { // 1. 獲取被攔截的目標(biāo)對(duì)象 StatementHandler statementHandler (StatementHandler) invocation.getTarget(); MetaObject metaObject SystemMetaObject.forObject(statementHandler); // 2. 獲取BoundSql它包含了SQL語(yǔ)句和參數(shù)映射信息 BoundSql boundSql statementHandler.getBoundSql(); Configuration configuration (Configuration) metaObject.getValue(delegate.configuration); // 3. 獲取方法名區(qū)分是prepare階段還是parameterize階段 Method method invocation.getMethod(); String methodName method.getName(); Object returnValue null; if (prepare.equals(methodName)) { // prepare階段可以獲取到原始的帶占位符的SQL String rawSql boundSql.getSql(); log.debug( Preparing: {}, formatSql(rawSql)); } else if (parameterize.equals(methodName)) { // parameterize階段參數(shù)已設(shè)置可以獲取到完整的帶參數(shù)的SQL // 注意直接獲取到的sql可能還是帶?的我們需要自己拼接參數(shù) String sql boundSql.getSql(); Object parameterObject boundSql.getParameterObject(); ListParameterMapping parameterMappings boundSql.getParameterMappings(); // 格式化SQL將?替換為實(shí)際參數(shù)值 String formattedSql formatSqlWithParameters(sql, parameterObject, parameterMappings, configuration); log.debug( Parameters: {}, formattedSql); // 也可以選擇在這里打印最終SQL但注意參數(shù)可能包含敏感信息 // log.debug( Executing SQL: {}, formatFinalSql(sql, parameterObject, parameterMappings, configuration)); } // 4. 繼續(xù)執(zhí)行原方法鏈 returnValue invocation.proceed(); // 5. 如果需要可以在執(zhí)行后打印影響行數(shù)或時(shí)間需額外攔截update/query方法 // 本例專注于打印SQL和參數(shù)結(jié)果集打印已被我們忽略 return returnValue; } /** * 格式化原始SQL美化換行等 */ private String formatSql(String sql) { return sql.replaceAll([\\s], ).trim(); } /** * 將SQL中的占位符?替換為實(shí)際的參數(shù)值用于DEBUG查看 * 注意此方法僅用于日志輸出不能用于實(shí)際執(zhí)行且需處理參數(shù)類型轉(zhuǎn)換。 */ private String formatSqlWithParameters(String sql, Object parameterObject, ListParameterMapping parameterMappings, Configuration configuration) { if (parameterMappings null || parameterMappings.isEmpty() || parameterObject null) { return sql; } TypeHandlerRegistry typeHandlerRegistry configuration.getTypeHandlerRegistry(); StringBuilder sqlBuilder new StringBuilder(sql); // 這里是一個(gè)簡(jiǎn)化的實(shí)現(xiàn)實(shí)際參數(shù)替換邏輯更復(fù)雜需要考慮多個(gè)參數(shù)、IN列表等。 // 更健壯的做法可以參考MyBatis自帶的ParameterHandler邏輯或者使用第三方工具。 // 此處僅作演示將參數(shù)以JSON格式附在SQL后面而不是替換?。 try { // 使用Fastjson、Jackson或Gson將參數(shù)對(duì)象轉(zhuǎn)換為字符串 // 示例String paramsJson JSON.toJSONString(parameterObject); // 為了簡(jiǎn)單這里直接調(diào)用toString() String paramsStr parameterObject.toString(); // 避免輸出過長(zhǎng)可以截?cái)?if (paramsStr.length() 500) { paramsStr paramsStr.substring(0, 500) ... [truncated]; } return sql -- Params: paramsStr; } catch (Exception e) { return sql -- [Parameter display error]; } } Override public Object plugin(Object target) { // 使用MyBatis提供的Plugin.wrap方法來(lái)創(chuàng)建代理對(duì)象 return Plugin.wrap(target, this); } Override public void setProperties(Properties properties) { // 可以從配置文件中讀取插件屬性此處暫無(wú)需求 } }代碼關(guān)鍵點(diǎn)解析Intercepts 和 Signature這是定義MyBatis插件攔截點(diǎn)的核心注解。我們攔截了StatementHandler接口的兩個(gè)方法prepare準(zhǔn)備語(yǔ)句和parameterize設(shè)置參數(shù)。這是打印SQL和參數(shù)的最佳時(shí)機(jī)。獲取BoundSqlBoundSql對(duì)象是MyBatis中承載一次SQL執(zhí)行所有信息的核心對(duì)象包括SQL文本、參數(shù)對(duì)象、參數(shù)映射列表。區(qū)分階段在prepare階段我們打印出原始的、帶?的SQL語(yǔ)句 Preparing:。在parameterize階段我們嘗試獲取并格式化參數(shù)信息 Parameters:。日志級(jí)別我們使用log.debug()進(jìn)行輸出。這意味著你需要在日志配置中為這個(gè)插件類com.yourcompany.yourproject.plugin.SqlLoggerInterceptor或它的包開啟DEBUG級(jí)別日志才會(huì)被打印出來(lái)。不打印結(jié)果集插件根本沒有攔截結(jié)果集處理的步驟如ResultSetHandler的handleResultSets方法所以自然就不會(huì)打印結(jié)果集。這正是我們想要的效果。3.4 配置與啟用自定義插件在Spring Boot中我們需要將自定義插件注冊(cè)到MyBatis的插件鏈中。由于我們使用了Component注解Spring會(huì)自動(dòng)管理這個(gè)Bean。但是我們需要確保它被添加到MyBatis的配置里。創(chuàng)建一個(gè)配置類package com.yourcompany.yourproject.config; import com.yourcompany.yourproject.plugin.SqlLoggerInterceptor; import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor; import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor; // 分頁(yè)插件示例 import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; Configuration public class MyBatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); // 添加分頁(yè)插件這是MyBatis-Plus的常用插件 interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); // 注意我們的SqlLoggerInterceptor是傳統(tǒng)的Interceptor // 需要單獨(dú)添加到SqlSessionFactory中而不是加到這里。 return interceptor; } /** * 單獨(dú)注冊(cè)我們的自定義SQL日志插件。 * 另一種方式是在SqlLoggerInterceptor類上直接使用Bean注解。 * 這里顯式聲明是為了更清晰地控制。 */ Bean public SqlLoggerInterceptor sqlLoggerInterceptor() { return new SqlLoggerInterceptor(); } }重要提示在Spring Boot MyBatis-Plus環(huán)境中只要插件類被Spring容器管理即加了Component或BeanMyBatis的自動(dòng)配置機(jī)制通常會(huì)自動(dòng)發(fā)現(xiàn)并注冊(cè)所有實(shí)現(xiàn)了Interceptor接口的Bean。所以上面的sqlLoggerInterceptor()Bean方法有時(shí)不是必須的Component注解可能就足夠了。但顯式聲明是一個(gè)好習(xí)慣可以避免因依賴掃描順序?qū)е碌膯栴}。3.5 配置日志輸出級(jí)別最后我們需要在application.yml中配置日志確保我們的插件能輸出日志而其他干擾日志被關(guān)閉。logging: level: # 1. 關(guān)閉MyBatis和JDBC的詳細(xì)日志防止結(jié)果集輸出 org.apache.ibatis: WARN java.sql: WARN java.sql.Connection: WARN java.sql.Statement: WARN java.sql.PreparedStatement: WARN java.sql.ResultSet: WARN # 2. 關(guān)閉你項(xiàng)目Mapper接口的詳細(xì)日志防止和插件輸出重復(fù) com.yourcompany.yourproject.mapper: WARN # 3. 為你自定義的插件類開啟DEBUG日志這樣我們打印的SQL才會(huì)顯示 com.yourcompany.yourproject.plugin.SqlLoggerInterceptor: DEBUG # 4. 如果你想知道插件是否被加載可以將其級(jí)別設(shè)為INFO或DEBUG com.yourcompany.yourproject.plugin: DEBUG pattern: console: %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n這個(gè)配置實(shí)現(xiàn)了精準(zhǔn)控制第1、2步關(guān)閉了所有可能輸出結(jié)果集和冗余SQL信息的源頭。第3步只為我們自定義的插件打開了DEBUG通道讓它能輸出我們精心格式化的“Preparing”和“Parameters”日志。啟動(dòng)你的Spring Boot應(yīng)用執(zhí)行一個(gè)查詢操作你將在控制臺(tái)看到類似如下的輸出并且絕對(duì)不會(huì)出現(xiàn)結(jié)果集數(shù)據(jù)2023-10-27 14:30:25.123 [http-nio-8080-exec-1] DEBUG c.y.y.p.SqlLoggerInterceptor - Preparing: SELECT id, username, email FROM user WHERE age ? 2023-10-27 14:30:25.124 [http-nio-8080-exec-1] DEBUG c.y.y.p.SqlLoggerInterceptor - Parameters: SELECT id, username, email FROM user WHERE age ? -- Params: 184. 高級(jí)優(yōu)化與生產(chǎn)實(shí)踐基礎(chǔ)的插件已經(jīng)能工作但在生產(chǎn)環(huán)境中我們還需要考慮更多細(xì)節(jié)。4.1 優(yōu)化SQL參數(shù)格式化上面的示例中formatSqlWithParameters方法實(shí)現(xiàn)得很簡(jiǎn)單只是將參數(shù)對(duì)象的toString()結(jié)果附在后面。這對(duì)于簡(jiǎn)單類型如Integer, String尚可但對(duì)于復(fù)雜對(duì)象、集合如List用于IN查詢或Map輸出可讀性很差。一個(gè)更專業(yè)的做法是模擬MyBatis內(nèi)置的日志實(shí)現(xiàn)將SQL中的?逐個(gè)替換為格式化的參數(shù)值。這里提供一個(gè)增強(qiáng)版的格式化方法思路private String formatSqlWithParametersEnhanced(String sql, Object parameterObject, ListParameterMapping parameterMappings, Configuration configuration) { if (parameterMappings null || parameterMappings.isEmpty()) { return sql; } TypeHandlerRegistry typeHandlerRegistry configuration.getTypeHandlerRegistry(); StringBuilder formattedSql new StringBuilder(); int index 0; int paramIndex 0; String sqlText sql; // 遍歷SQL字符串找到?并替換 for (ParameterMapping mapping : parameterMappings) { int qIndex sqlText.indexOf(?, index); if (qIndex -1) { break; } formattedSql.append(sqlText, index, qIndex); // 追加?之前的部分 // 獲取參數(shù)值 Object value; String propertyName mapping.getProperty(); if (boundSql.hasAdditionalParameter(propertyName)) { value boundSql.getAdditionalParameter(propertyName); } else if (parameterObject null) { value null; } else if (typeHandlerRegistry.hasTypeHandler(parameterObject.getClass())) { value parameterObject; } else { // 從參數(shù)對(duì)象中獲取屬性值這里簡(jiǎn)化了實(shí)際需處理復(fù)雜對(duì)象圖 MetaObject metaObject configuration.newMetaObject(parameterObject); value metaObject.getValue(propertyName); } // 格式化參數(shù)值用于顯示 formattedSql.append(formatParameterValue(value)); index qIndex 1; paramIndex; } formattedSql.append(sqlText.substring(index)); // 追加剩余部分 return formattedSql.toString(); } private String formatParameterValue(Object value) { if (value null) { return null; } if (value instanceof String || value instanceof Character) { return value.toString().replace(, ) ; } if (value instanceof Date) { return new SimpleDateFormat(yyyy-MM-dd HH:mm:ss).format((Date) value) ; } // 其他類型直接返回字符串形式 return value.toString(); }注意上述增強(qiáng)格式化邏輯較為復(fù)雜且需要處理BoundSql的additionalParameters等細(xì)節(jié)。在實(shí)際項(xiàng)目中如果你需要完美的參數(shù)替換效果可以考慮直接使用MyBatis內(nèi)置的ParameterHandler邏輯或者參考開源項(xiàng)目如p6spy的思路。對(duì)于大多數(shù)調(diào)試場(chǎng)景將參數(shù)以JSON形式附在SQL后面如初始示例已經(jīng)足夠清晰。4.2 集成性能監(jiān)控與慢查詢?nèi)罩炯热晃覀円呀?jīng)有了一個(gè)插件攔截了SQL執(zhí)行很容易就能擴(kuò)展其功能例如添加執(zhí)行時(shí)間計(jì)算實(shí)現(xiàn)慢查詢警告。修改SqlLoggerInterceptor的intercept方法我們主要攔截StatementHandler的query或update方法這需要修改Signature并在方法執(zhí)行前后記錄時(shí)間。更簡(jiǎn)單的方式是我們可以創(chuàng)建一個(gè)獨(dú)立的性能監(jiān)控插件。這里展示如何在一個(gè)插件里集成簡(jiǎn)單計(jì)時(shí)Intercepts({ Signature(type StatementHandler.class, method update, args {Statement.class}), Signature(type StatementHandler.class, method query, args {Statement.class, ResultHandler.class}) }) public class PerformanceAndSqlLoggerInterceptor implements Interceptor { private static final long SLOW_QUERY_THRESHOLD_MS 1000; // 慢查詢閾值1秒 Override public Object intercept(Invocation invocation) throws Throwable { long startTime System.currentTimeMillis(); // ... (這里可以調(diào)用之前的邏輯打印SQL或獨(dú)立打印) ... StatementHandler handler (StatementHandler) invocation.getTarget(); BoundSql boundSql handler.getBoundSql(); String sql boundSql.getSql(); log.debug(Executing SQL: {}, formatSql(sql)); Object result invocation.proceed(); // 執(zhí)行SQL long endTime System.currentTimeMillis(); long cost endTime - startTime; if (cost SLOW_QUERY_THRESHOLD_MS) { log.warn(Slow SQL detected! Cost: {} ms, SQL: {}, cost, formatSql(sql)); } else { log.debug(SQL executed. Cost: {} ms, cost); } // 關(guān)鍵不打印result對(duì)象本身 return result; } // ... plugin, setProperties 方法 ... }這個(gè)插件在查詢/更新執(zhí)行后計(jì)算耗時(shí)并對(duì)慢查詢進(jìn)行WARN級(jí)別的報(bào)警同時(shí)依然不輸出結(jié)果集內(nèi)容。4.3 敏感信息脫敏處理在生產(chǎn)環(huán)境中SQL日志可能包含敏感信息如手機(jī)號(hào)、郵箱、身份證號(hào)等。直接在日志中打印這些數(shù)據(jù)是危險(xiǎn)的。我們需要在插件中對(duì)參數(shù)值進(jìn)行脫敏。可以在formatParameterValue方法中加入脫敏邏輯private String formatParameterValue(Object value) { if (value null) { return null; } String strValue value.toString(); // 簡(jiǎn)單示例對(duì)可能是手機(jī)號(hào)、郵箱的參數(shù)進(jìn)行脫敏這里需要更精確的字段名判斷 // 實(shí)際項(xiàng)目中可以維護(hù)一個(gè)需要脫敏的字段名列表或正則規(guī)則 // 假設(shè)通過某種方式如解析ParameterMapping的property知道當(dāng)前參數(shù)對(duì)應(yīng)字段名 String fieldName getCurrentFieldName(); // 這是一個(gè)需要實(shí)現(xiàn)的方法 if (fieldName ! null (fieldName.contains(phone) || fieldName.contains(mobile))) { // 手機(jī)號(hào)脫敏138****1234 if (strValue.length() 11) { return strValue.substring(0, 3) **** strValue.substring(7) ; } } if (fieldName ! null fieldName.contains(email)) { // 郵箱脫敏a***example.com int atIndex strValue.indexOf(); if (atIndex 1) { return strValue.charAt(0) *** strValue.substring(atIndex) ; } } // ... 其他類型格式化 ... return strValue ; }實(shí)操心得脫敏邏輯的復(fù)雜性取決于你的需求。一種更通用的做法是在插件中不直接進(jìn)行復(fù)雜的脫敏而是將原始SQL和參數(shù)記錄下來(lái)發(fā)送到專門的安全日志處理服務(wù)如ELK棧并配置脫敏管道在存儲(chǔ)和展示前進(jìn)行統(tǒng)一的脫敏處理。這樣業(yè)務(wù)代碼更干凈脫敏規(guī)則也更容易集中管理。5. 常見問題排查與解決方案實(shí)錄在實(shí)際配置和使用過程中你可能會(huì)遇到以下問題5.1 插件不生效沒有日志輸出可能原因及排查步驟插件未正確注冊(cè)確保你的插件類被Spring容器管理有Component或Bean注解并且所在的包在Spring Boot的主應(yīng)用掃描路徑下?？梢酝ㄟ^在插件的構(gòu)造方法或PostConstruct方法中打日志來(lái)驗(yàn)證是否被實(shí)例化。日志級(jí)別配置錯(cuò)誤這是最常見的原因。檢查application.yml中l(wèi)ogging.level下的配置。確保你的插件類如com.yourcompany.yourproject.plugin.SqlLoggerInterceptor的日志級(jí)別是DEBUG或TRACE。同時(shí)確保全局的日志框架如Logback的根級(jí)別沒有覆蓋為ERROR。MyBatis-Plus版本兼容性不同版本的MyBatis-Plus對(duì)插件的自動(dòng)注冊(cè)機(jī)制可能有細(xì)微差別。如果懷疑是此問題可以嘗試在配置類中顯式地將插件添加到SqlSessionFactoryBean中。Bean public SqlSessionFactory sqlSessionFactory(DataSource dataSource, SqlLoggerInterceptor sqlLoggerInterceptor) throws Exception { MybatisSqlSessionFactoryBean factoryBean new MybatisSqlSessionFactoryBean(); factoryBean.setDataSource(dataSource); // 手動(dòng)添加攔截器 factoryBean.setPlugins(new Interceptor[]{sqlLoggerInterceptor}); return factoryBean.getObject(); }多個(gè)插件沖突如果你配置了多個(gè)MyBatis插件如分頁(yè)插件、樂觀鎖插件需要確保它們的執(zhí)行順序不會(huì)導(dǎo)致某個(gè)插件“吃掉”異?；蚋淖儓?zhí)行流程。通常日志插件應(yīng)該放在插件鏈的最外層最先執(zhí)行。5.2 日志輸出重復(fù)SQL被打印兩次可能原因及排查步驟MyBatis原生日志未關(guān)閉你雖然配置了自定義插件但MyBatis原生的log-impl例如StdOutImpl或Slf4jImpl仍然在工作并且其日志級(jí)別也是DEBUG。這會(huì)導(dǎo)致SQL被打印兩次一次來(lái)自你的插件一次來(lái)自MyBatis自身。解決方案確保在application.yml中將mybatis-plus.configuration.log-impl設(shè)置為一個(gè)不輸出的實(shí)現(xiàn)或者不配置使用默認(rèn)的空實(shí)現(xiàn)并且將org.apache.ibatis和java.sql相關(guān)Logger的級(jí)別設(shè)為WARN如上文配置所示。多個(gè)自定義日志插件檢查是否無(wú)意中創(chuàng)建了多個(gè)功能相似的插件或者將插件注冊(cè)了多次。5.3 參數(shù)格式化顯示為null或不正確可能原因及排查步驟參數(shù)對(duì)象為null如果執(zhí)行的SQL沒有參數(shù)parameterObject可能為null。參數(shù)映射復(fù)雜對(duì)于動(dòng)態(tài)SQL如if標(biāo)簽、foreach循環(huán)用于IN查詢或嵌套參數(shù)對(duì)象BoundSql中的parameterMappings和parameterObject結(jié)構(gòu)會(huì)變得復(fù)雜。上面提供的簡(jiǎn)單格式化方法無(wú)法正確處理這些情況。解決方案對(duì)于生產(chǎn)環(huán)境如果對(duì)參數(shù)可讀性要求高建議采用更穩(wěn)健的方案方案A使用第三方SQL打印工具如p6spy。它可以無(wú)縫集成提供非常完善的SQL格式化包含參數(shù)替換并且完全獨(dú)立于MyBatis的日志系統(tǒng)。方案B只打印帶?的SQL和參數(shù)對(duì)象的JSON快照就像我們第一個(gè)簡(jiǎn)單示例那樣。雖然不夠完美但足夠用于大多數(shù)調(diào)試場(chǎng)景且實(shí)現(xiàn)簡(jiǎn)單穩(wěn)定。方案C深入研讀MyBatis源碼實(shí)現(xiàn)一個(gè)能處理所有復(fù)雜情況的參數(shù)提取器。這需要投入較多精力。5.4 性能影響可能原因及排查步驟DEBUG日志開銷即使日志最終不被輸出因?yàn)锳ppender配置判斷日志級(jí)別isDebugEnabled()和拼接參數(shù)字符串尤其是復(fù)雜對(duì)象的JSON序列化本身也有開銷。解決方案在插件的日志輸出前使用if (log.isDebugEnabled())進(jìn)行判斷避免不必要的字符串拼接。在生產(chǎn)環(huán)境中通過日志配置將插件類的日志級(jí)別設(shè)為INFO或WARN徹底關(guān)閉SQL打印功能?？紤]使用異步日志框架如Log4j2的AsyncLogger來(lái)減少I/O阻塞對(duì)業(yè)務(wù)線程的影響。插件本身邏輯復(fù)雜如果插件的intercept方法里做了太多事情如復(fù)雜的脫敏、遠(yuǎn)程調(diào)用等會(huì)影響每個(gè)SQL的執(zhí)行速度。解決方案保持插件邏輯精簡(jiǎn)。將非關(guān)鍵操作如慢查詢統(tǒng)計(jì)的聚合上報(bào)、脫敏字典查詢改為異步或批量處理。我個(gè)人在實(shí)際項(xiàng)目中的體會(huì)是通過自定義插件控制SQL日志輸出是一個(gè)一勞永逸的解決方案。初期搭建需要花費(fèi)一些時(shí)間理解MyBatis的攔截器機(jī)制和日志框架配置但一旦配置成功它帶來(lái)的整潔日志、可控輸出和強(qiáng)大的擴(kuò)展能力如集成慢查詢監(jiān)控會(huì)讓日常開發(fā)和運(yùn)維排查效率大幅提升。最關(guān)鍵的是它完美地解決了“結(jié)果集刷屏”這個(gè)痛點(diǎn)讓日志文件重新變得清晰可讀。在配置過程中務(wù)必記得“關(guān)閉其他只開自己”的日志級(jí)別配置原則這是避免日志混亂的關(guān)鍵。