Spring Boot 项目启动失败的解决方案
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 关注：
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 抽象类即可：
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 的过程中手动抛出一个自定义的异常：
@Bean
public CommandLineRunner commandLineRunner(){
throw new JavastackException("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 项目启动失败的解决方案的详细内容，更多关于Spring Boot 项目启动失败的资料请关注脚本之家其它相关文章！
相关文章
在开发SpringBoot程序的过程中,有可能与其他业务系统进行对接开发,获取封装公共的API接口等等,下面这篇文章主要给大家介绍了关于SpringBoot常见的注解的相关资料,需要的朋友可以参考下2022-06-06
这篇文章主要为大家详细介绍了Java将数字金额转为大写中文金额，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2019-08-08
这篇文章主要介绍了Spring Cloud Eureka: 指定Zone方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2022-03-03
这篇文章主要介绍了使用JavaIO流和网络制作一个简单的图片爬虫,通过关键字爬取百度图片，这个和我们使用搜索引擎搜索百度图片是一样的，只是通过爬虫可以学习技术的使用,需要的朋友可以参考下2023-04-04
这篇文章主要为大家详细介绍了java读取excel表格的方法，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2020-12-12
这篇文章主要介绍了SpringBoot中请求参数绑定及使用详解,在Web应用程序中，请求参数绑定是非常重要的操作,Spring Boot框架使得请求参数绑定变得非常简单，通过使用注解和预定义的类可以轻松地实现此操作,需要的朋友可以参考下2023-08-08
本文将探讨这两种流行的编程语言之间的性能差异,无论你是刚刚入门编程还是已经有一定经验,这个指南都将帮助你了解Python和Java在执行速度、内存管理以及扩展性方面的不同,通过比较这两种语言的特点和优势,你将能够更好地选择适合自己项目需求的编程语言,让我们开始吧！2023-12-12
这篇文章主要给大家介绍了在Java 8中如何获取参数名称的方法，文中给出了详细的介绍和方法示例，相信对大家的理解和学习具有一定的参考借鉴价值，有需要的朋友可以参考学习，下面来一起看看吧。2017-01-01
这篇文章主要介绍了Java getParameter方法案例详解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下2021-08-08
这篇文章主要介绍了Java SSM配置文件案例详解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下2021-08-08
最新评论