在SpringBoot中使用logback優化異常堆疊的輸出

huan1993發表於2022-05-09

一、背景

在我們在編寫程式的過程中，無法保證自己的程式碼不丟擲異常。當我們丟擲異常的時候，通常會將整個異常堆疊的資訊使用日誌記錄下來。通常一整個異常堆疊的資訊是比較多的，而且存在一些沒用的資訊。那麼我們如何優化一些異常堆疊的資訊列印，過濾掉不必要的資訊呢？

二、需求

1、現有的異常堆疊資訊

現有的異常堆疊資訊

2、我們想優化成如下

優化後的堆疊資訊

三、使用的技術

1、此處我們是在SpringBoot中使用logback來實現日誌的列印。
2、預設情況下，重寫異常堆疊的列印比較複雜，此處我們採用第三方實現 ogstash-logback-encoder 來實現。
自定義異常堆疊
3、那麼此處我們就採用 ogstash-logback-encoder 的 ShortenedThrowableConverter來實現。這個可以在以json格式的日誌輸出中使用，也可以使用到非json格式的日誌中使用。我們將會用在以非json格式日誌的輸出。

四、技術實現

1、引入依賴

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!-- 引入此jar包，可以將日誌以json的格式輸出，可以簡化異常資訊的輸出 -->
<dependency>
    <groupId>net.logstash.logback</groupId>
    <artifactId>logstash-logback-encoder</artifactId>
    <version>7.1.1</version>
</dependency>

注意：
使用logstash-logback-encoder有一些依賴項，我當前使用的依賴項如下：

1、如果發生了異常

如果發生了異常

2、jdk的版本依賴

jdk的版本依賴
版本不同，可能依賴的版本也不一樣，推薦檢視官方網址：https://github.com/logfellow/logstash-logback-encoder#java-version-requirements

2、程式碼實現

程式碼實現

3、使用 ShortenedThrowableConverter 來優化異常堆疊

1、新建 logback-spring.xml配置檔案
2、通過 conversionRule來使用

3、具體用法

引數解釋：

stack{100,16,2048,rootFirst,regex1,regex2,evaluatorName}
        引數解釋： 建議檢視原始碼 net.logstash.logback.stacktrace.ShortenedThrowableConverter#parseOptions() 方法
            第1引數： maxDepthPerThrowable：值可以是 full或者short或者int值，表示每個異常最多列印多少個 stackTraceElements 元素
            第2引數： shortenedClassNameLength：值可以是 full或者short或者int值，將嘗試將類名長度縮短到小於此值
                     com.huan.springboot.service.ExceptionService 可能會變成 c.h.s.s.ExceptionService
            第3引數： maxLength：值可以是 full或者short或者int值，指的輸出到日誌中整個堆疊最大能存在多少個字元。
            後面這些引數沒有固定順序
            第4引數： rootFirst： 可選引數，如果使用該引數，值就是 rootFirst ,表示應首先列印堆疊的根本原因
            第5引數： inlineHash： 可選引數，如果使用該引數，值就是 inlineHash, 指示應該計算和內聯十六進位制錯誤雜湊
            如果引數都不是上方的型別，那麼可能是 evaluator 或者 exclude 型別，這2個都是判斷這個 stackTraceElement 是否應該被列印，這2個引數沒有順序關係
                evaluator： 值的是需要實現 EventEvaluator<ILoggingEvent> 的類
                exclude： 指的是需要排除的正規表示式， 如果存在.需要轉義成 \.