Spring Boot 常见错误及解决方法

痛定思痛。 2021-08-19 19:03 640阅读 0赞

## **导读** ##

Spring Boot 作为 Java 生态中最流行的开发框架，意味着被数以万计的开发者所使用。下面根据我们自身遇到的问题，加上用户提供的一些反馈，来大致梳理下 Spring Boot 的常见错误及解决方法。

**找不到配置？****配置不对？配置被覆盖?**

--------------------

Spring Boot 配置加载过程解析:

1、Spring Boot 配置的加载有着约定俗成的步骤: 从 resources 目录下加载

application.properties/application.yml ;

再根据里面的

spring.profiles.active

来加载不同 profile 的配置文件

application-dev.properties/application-dev.yml

(比如加载 profile 为 dev 的配置文件)。

2、Spring Boot 所有的配置来源会被构造成 PropertySource，比如 -D 参数, -- 参数, 系统参数, 配置文件配置等等。这些 PropertySource 最终会被添加到 List 中，获取配置的时候会遍历这个 List ，直到第一次获取对应 key 的配置，所以会存在优先级的问题。具体配置的优先级参考:

* **https://stackoverflow.com/a/45822571*

配置覆盖案例:

Nacos 服务注册的 IP 可以通过 spring.cloud.nacos.discovery.ip 设置，当我们打成 JAR 包之后，如需修改注册 IP，可以通过

\-Dspring.cloud.nacos.discovery.ip=xxx

（-D参数配置的优先级比配置文件要高)。

配置问题排查:

进入 http://host:port/actuator/env  这个 endpoint 查看具体的配置项属于哪个 PropertySource。

**Jar 包启动不了**

--------------------

执行 Spring Boot 构建的 jar 包后，返回 "my.jar中没有主清单属性" 错误。

错误分析: Spring Boot 的正常 jar 包运行方是通过 spring-boot-loader 这个模块里的 JarLauncher 完成的，该类内部提供了一套运行的规范。

解决方案: 在 pom 里加上 spring-boot-maven-plugin 的 maven 插件配置(该插件会在 jar 里加入 spring-boot-loader 的代码，并在 MANIFEST.MF 中的 Main-Class 里写入 JarLauncher):

<plugin>
    	<groupId>org.springframework.boot</groupId>
    	<artifactId>spring-boot-maven-plugin</artifactId>
    </plugin>

## **自动化配置类没有被加载** ##

--------------------

条件注解是 Spring Boot 的核心特性之一，第三方的 starter 或我们自定义的 starter 内部都会加载一些 AutoConfiguration，有时候会存在一些 AutoConfiguration 没有被加载的情况。导致出现 NoSuchBeanDefinitionException, UnsatisfiedDependencyException 等异常

排查步骤(三种方式):

1、把 spring 的日志级别调到 debug 级别:

logging.level.org.springframework: debug。

2、从 ApplicationContext 中获取 ConditionEvaluationReport，得到内部的 ConditionEvaluationReport.ConditionAndOutcomes 类中的输出信息。

3、进入 http://host:port/actuator/conditions 这个 endpoint 查看条件注解的 match 情况。

TIps：欢迎关注微信公众号：Java后端

这是日志打印的不满足条件的 AutoConfiguratoin:

Unconditional classes:
    ----------------------
    
        org.springframework.boot.autoconfigure.context.ConfigurationPropertiesAutoConfiguration
    
        org.springframework.cloud.client.ReactiveCommonsClientAutoConfiguration
    
        org.springframework.boot.actuate.autoconfigure.info.InfoContributorAutoConfiguration
    
        org.springframework.boot.autoconfigure.context.PropertyPlaceholderAutoConfiguration
    
        org.springframework.cloud.client.discovery.simple.SimpleDiscoveryClientAutoConfiguration
    
        org.springframework.cloud.client.CommonsClientAutoConfiguration
    
        org.springframework.cloud.commons.httpclient.HttpClientConfiguration
    
        org.springframework.boot.actuate.autoconfigure.endpoint.EndpointAutoConfiguration
    
        org.springframework.cloud.loadbalancer.config.BlockingLoadBalancerClientAutoConfiguration

## **定义的 Component 没有被扫描到** ##

--------------------

## @SpringBootApplication 注解内部也会使用 @ComponentScan 注解用于扫描 Component 。默认情况下会扫描 @SpringBootApplication 注解修饰的入口类的包以及它下面的子包中所有的 Component 。    ##

## @ComponentScan： ##

## *https://github.com/StabilityMan/StabilityGuide/blob/master/ComponentScan* ##

这是推荐的包结构中项目的结构:

![format_png][]

exclude 包下的类不会被扫描到，card 包下的类会被扫描到。

**Actuator Endpoint 访问不了**

--------------------

访问 Actuator，出现 404 错误。

解决方案:

1、Spring Boot 2.x 版本对 Actuator 做了大量的修改，其中访问的路径从

http://host:port/endpointid

变成了

http://host:port/actuator/endpointid 。

确保访问的路径正确。

2、Endpoint 有 Security 要求，

在配置里加上 management.endpoints.web.exposure.include=\* 即可。

**- END -**

**推****荐****阅****读 **

***1.*** [扎心一问：分库分表就能无限扩容吗][Link 1]

***2. ***[全面了解 Nginx 主要应用场景][Nginx]

***3.*** [一场近乎完美基于 Dubbo 的微服务改造实践][Dubbo]

***4.*** [什么是一致性 Hash 算法？][Hash]

***5.***  [团队开发中 Git 最佳实践][Git]

![format_png 1][]

**喜****欢****文****章****，****点****个****在看 **![format_png 2][]

[format_png]: /images/20210730/1d1d3b3e9b2e4a81b7342a88af3373bf.png
[Link 1]: https://blog.csdn.net/qq_37217713/article/details/103917809
[Nginx]: https://blog.csdn.net/qq_37217713/article/details/103867187
[Dubbo]: http://mp.weixin.qq.com/s?__biz=Mzg2MjEwMjI1Mg%3D%3D&chksm=ce0da97ff97a20698d70c73bbfb05bd550cdbc2551f26503d65bacf48b13eaee057876786cad&idx=2&mid=2247491324&scene=21&sn=0609a429071c9ff699c11dad19be1b78#wechat_redirect
[Hash]: https://blog.csdn.net/qq_37217713/article/details/103535328
[Git]: https://blog.csdn.net/qq_37217713/article/details/102481709
[format_png 1]: /images/20210730/d94da83f297b49d1ba0750d38da79a65.png
[format_png 2]: /images/20210730/381507a25fc94455abe2197cf33a3110.png