Spring Boot 專案是不是經常失敗，顯示一大堆的錯誤資訊，如埠重復系結時會列印以下例外：
***************************
APPLICATION FAILED TO START
***************************
Description:
Embedded servlet container failed to start. Port 8080 was already in use.
Action:
Identify and stop the process that's listening on port 8080 or configure this application to listen on another port.
這個大家應該很熟悉了吧！
錯誤資訊大家都能看懂，但很不友好，那么，Spring Boot 是怎么實作這樣一個例外錯誤資訊輸出的呢？今天堆疊長分享一個 Spring Boot 啟動失敗的簡單易懂的玩法，讓新來的實習生 1 秒都能看出問題，
如果你對 Spring Boot 還不是很熟悉，或者只是會簡單的使用，那還是建議你深入學習下吧，推薦這個 Spring Boot 學習倉庫，歡迎 Star 關注：
https://github.com/javastacks/spring-boot-best-practice
Failure Analyzers 介紹
Spring Boot 中注冊了許多 "Failure Analyzers"，即 "失敗分析器"，Spring Boot 中的啟動失敗的場景都是由這些失敗分析器攔截處理的，
Spring Boot 提供了 FailureAnalyzers 介面：
package org.springframework.boot.diagnostics;
/**
* A {@code FailureAnalyzer} is used to analyze a failure and provide diagnostic
* information that can be displayed to the user.
*
* @author Andy Wilkinson
* @since 1.4.0
*/
@FunctionalInterface
public interface FailureAnalyzer {
/**
* Returns an analysis of the given {@code failure}, or {@code null} if no analysis
* was possible.
* @param failure the failure
* @return the analysis or {@code null}
*/
FailureAnalysis analyze(Throwable failure);
}
這個介面的目的就是： 分析啟動失敗例外并顯示給用戶有用的診斷資訊，
Spring Boot 內置注冊的所有失敗分析器在這個檔案里面：
/org/springframework/boot/spring-boot/2.3.5.RELEASE/spring-boot-2.3.5.RELEASE-sources.jar!/META-INF/spring.factories
注冊的所有失敗分析器串列：
# Failure Analyzers
org.springframework.boot.diagnostics.FailureAnalyzer=\
org.springframework.boot.context.properties.NotConstructorBoundInjectionFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.BeanCurrentlyInCreationFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.BeanDefinitionOverrideFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.BeanNotOfRequiredTypeFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.BindFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.BindValidationFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.UnboundConfigurationPropertyFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.ConnectorStartFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.NoSuchMethodFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.NoUniqueBeanDefinitionFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.PortInUseFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.ValidationExceptionFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.InvalidConfigurationPropertyNameFailureAnalyzer,\
org.springframework.boot.diagnostics.analyzer.InvalidConfigurationPropertyValueFailureAnalyzer
再回到上面的埠重復系結啟動失敗例外，就是注冊了 PortInUseFailureAnalyzer 這個失敗分析器，可以看到 PortInUseFailureAnalyzer 失敗分析器就在注冊串列里面，
再來看下 PortInUseFailureAnalyzer 的原始碼：
/**
* A {@code FailureAnalyzer} that performs analysis of failures caused by a
* {@code PortInUseException}.
*
* @author Andy Wilkinson
*/
class PortInUseFailureAnalyzer extends AbstractFailureAnalyzer<PortInUseException> {
@Override
protected FailureAnalysis analyze(Throwable rootFailure, PortInUseException cause) {
return new FailureAnalysis("Web server failed to start. Port " + cause.getPort() + " was already in use.",
"Identify and stop the process that's listening on port " + cause.getPort() + " or configure this "
+ "application to listen on another port.",
cause);
}
}
只要應用啟動程序上拋出了 PortInUseException 例外就會被這個失敗分析器攔截并輸出可讀性的錯誤資訊，現在知道系結重復系結錯誤是怎么輸出的了，
自定義 Failure Analyzers
從內置的失敗分析器中可以發現，所有的分析器都繼承了這個抽象基類是：AbstractFailureAnalyzer，它實作了 FailureAnalyzer 介面，一般基于這個抽象基類就可以實作自定義失敗分析器的擴展，
下面堆疊長通過兩個示例帶大家了解下，如何擴展或者自定義一個 FailureAnalyzer，
1、重寫埠失敗分析器
比如說上面的PortInUseFailureAnalyzer 輸出內容是英文的，不是很直觀的看出，我們可以自己實作一個中文的埠失敗分析器，
很簡單，創建一個失敗分析器繼承 AbstractFailureAnalyzer 抽象類即可：
/**
* 來源微信公眾號：Java技術堆疊
*/
package cn.javastack.springboot.features.analyzer;
import org.springframework.boot.diagnostics.AbstractFailureAnalyzer;
import org.springframework.boot.diagnostics.FailureAnalysis;
import org.springframework.boot.web.server.PortInUseException;
public class PortInUseFailureAnalyzer extends AbstractFailureAnalyzer<PortInUseException> {
@Override
protected FailureAnalysis analyze(Throwable rootFailure, PortInUseException cause) {
return new FailureAnalysis("你啟動的埠 " + cause.getPort() + " 被占用了.",
"快檢查下埠 " + cause.getPort() + " 被哪個程式占用了，或者強制殺掉行程.",
cause);
}
}
重寫 analyze 方法，并回傳一個 FailureAnalysis 物件，FailureAnalysis 類的三個主要資訊分別是：
public FailureAnalysis(String description, String action, Throwable cause) {
this.description = description;
this.action = action;
this.cause = cause;
}
即要展示的：可讀性的錯誤描述、建議的檢查修復動作、原始例外，
然后在自己的資源目錄下創建 META-INF/spring.factories 檔案，內容添加：
org.springframework.boot.diagnostics.FailureAnalyzer=\
cn.javastack.springboot.features.analyzer.PortInUseFailureAnalyzer
啟動輸出：
***************************
APPLICATION FAILED TO START
***************************
Description:
你啟動的埠 8080 被占用了.
Action:
快檢查下埠 8080 被哪個程式占用了，或者強制殺掉行程.
這樣重新實作一下是不是要清楚多了？實習生都能看懂！
2、自定義失敗分析器
下面再來自定義一個全新的失敗分析器，讓大家能更清楚的認識失敗分析器，
我們在創建 Bean 的程序中手動拋出一個自定義的例外：
/**
* 來源微信公眾號：Java技術堆疊
*/
@Bean
public CommandLineRunner commandLineRunner(){
throw new JavastackException("Java技術堆疊例外");
}
添加一個失敗分析器攔截該例外：
/**
* 來源微信公眾號：Java技術堆疊
*/
package cn.javastack.springboot.features.analyzer;
import org.springframework.boot.diagnostics.AbstractFailureAnalyzer;
import org.springframework.boot.diagnostics.FailureAnalysis;
public class JavastackFailureAnalyzer extends AbstractFailureAnalyzer<JavastackException> {
@Override
protected FailureAnalysis analyze(Throwable rootFailure, JavastackException cause) {
return new FailureAnalysis("Java技術堆疊發生例外了……",
"趕快去檢查一下吧！",
cause);
}
}
添加注冊：
org.springframework.boot.diagnostics.FailureAnalyzer=\
cn.javastack.springboot.features.analyzer.PortInUseFailureAnalyzer,\
cn.javastack.springboot.features.analyzer.JavastackFailureAnalyzer
啟動輸出：
***************************
APPLICATION FAILED TO START
***************************
Description:
Java技術堆疊發生例外了……
Action:
趕快去檢查一下吧！
如果不注冊該失敗分析器，這個自定義的例外就不會被內置的失敗分析器攔截，就會輸出大堆的例外資訊，使用失敗分析器能很直觀的看出是什么錯誤及怎么修復這個錯誤，
總結
Spring Boot 提供的失敗分析器以友好的錯誤資訊和修復建議代替了大堆的錯誤例外資訊，可以幫助我們更直觀的定位應用啟動故障，你學會了嗎？
本文的所有示例源代碼都已上傳到了 Github：
https://github.com/javastacks/spring-boot-best-practice
歡迎大家 Star 關注，后續會不斷更新，
學習更多 Spring Boot 教程，請關注公眾號Java技術堆疊，在后臺回復：boot，歷史 Spring Boot 教程我都整理好了，
最后，別忘了點在看、轉發哦，需要你的鼓勵～
著作權申明：本文系公眾號 "Java技術堆疊" 原創，原創實屬不易，轉載、參考本文內容請注明出處，禁止抄襲、洗稿，請自重，尊重他人勞動成果和知識產權，
近期熱文推薦：
1.600+ 道 Java面試題及答案整理(2021最新版)
2.終于靠開源專案弄到 IntelliJ IDEA 激活碼了，真香！
3.阿里 Mock 工具正式開源，干掉市面上所有 Mock 工具！
4.Spring Cloud 2020.0.0 正式發布，全新顛覆性版本！
5.《Java開發手冊（嵩山版）》最新發布，速速下載！
覺得不錯，別忘了隨手點贊+轉發哦！
轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/265288.html
標籤：其他
上一篇：Python Tkinter 視窗的管理與設定（四）：布局管理器
下一篇：物件、類