`

Spring Boot 常见错误及解决方法

阅读更多

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 情况。

这是日志打印的不满足条件的 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

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

Spring Boot 常见错误及解决方法

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=* 即可。

 

https://www.infoq.cn/article/Bri5Kou8LLy5CpiBSeqy

 

分享到:
评论

相关推荐

    Spring Boot 常见错误及解决方法.docx

    Spring Boot 常见错误及解决方法

    Spring Boot整合Spring Batch,实现批处理

    在Java开发领域,Spring Boot和Spring Batch的整合是构建高效批处理系统的一种常见方式。Spring Boot以其简洁的配置和快速的启动能力深受开发者喜爱,而Spring Batch作为Spring框架的一部分,专注于批量处理任务,...

    spring boot面试题及答案.docx

    - **提供默认配置**:Spring Boot为许多常见场景提供了合理的默认配置,减少了配置文件的编写。 - **内嵌Servlet容器**:Spring Boot默认内置了Tomcat、Jetty等Servlet容器,无需额外配置。 - **环境感知配置**:...

    SpringBoot常见错误及解决方法1

    SpringBoot常见错误及解决方法 Spring Boot 作为 Java 生态中最流行的开发框架,意味着被数以万计的开发者所使用。解决 Spring Boot 中的常见错误需要了解 Spring Boot 的配置加载过程和优先级问题。 配置加载过程...

    Spring Boot笔记

    基于给定的信息“Spring Boot笔记”,我们可以...- 如何处理IDEA或Eclipse中的常见错误提示。 通过这些详细的步骤,可以帮助我们更好地理解和掌握Spring Boot的环境配置过程,从而更顺利地完成项目的搭建和开发工作。

    spring-boot-assistant-222.17.2

    本文将深入探讨Spring Boot Assistant插件在IntelliJ IDEA中的使用方法和核心功能。 首先,让我们了解一下Spring Boot Assistant的基本信息。该插件的最新版本为"222.17.2",这个版本号通常代表了插件的更新日期和...

    spring-boot-parent.rar

    下载 "spring-boot-parent.rar" 可能是为了快速获得一个已经验证过的配置,以避免常见的错误。 7. **POM.xml or build.gradle**:如果是Maven项目,关键文件将是 `pom.xml`,它包含了父项目的配置信息。如果是...

    spring-boot中文API文档

    13. **常见问题**:解答在使用Spring Boot过程中可能遇到的问题,以及如何解决。 这份中文API文档不仅对初学者有指导意义,也为经验丰富的开发者提供了详细的参考信息,帮助他们深入理解Spring Boot的内部工作原理...

    spring boot管理系统后台

    综上所述,这个“spring boot管理系统后台”项目涵盖了Spring Boot的核心技术、MyBatis的数据持久化、Bootstrap的前端构建以及可能涉及的安全、API设计、错误处理等多个方面,是一个全面的后台管理解决方案。...

    spring boot 入门案例

    在这个入门案例中,我们将探讨如何使用 Spring Boot 实现基本的网页展示和数据库查询功能,并处理潜在的错误。 首先,我们来了解一下 Spring Boot 的基本架构。Spring Boot 依赖于 Starter POMs,这些 POMs 是预...

    spring boot demo 集合

    8. **安全**:Spring Boot集成了Spring Security,用于处理认证和授权,提供了一套强大的安全解决方案。 9. **云服务集成**:Spring Boot可以方便地与云平台如Heroku、Cloud Foundry集成,支持服务发现、配置中心等...

    Spring Boot 通用工程

    "spring-boot-common-master"这个文件可能是一个包含Spring Boot通用功能和配置的项目模板,可能包括了日志、安全、数据访问、错误处理等基础模块,为开发者提供了一个快速启动新项目的起点。通过学习和理解这个模板...

    spring boot oauth2 jwt 中文文档.docx

    OAuth2 授权框架与 Spring Boot 集成指南 OAuth2 授权框架是一种协议,允许用户授权第三方网站或应用程序访问用户受保护的资源,而不必披露其长期凭据甚至身份。OAuth 引入了一个授权层,将客户端角色与资源所有者...

    创建Spring boot的三种方式

    创建 Spring Boot 项目有多种方式,本文将介绍三种常见的创建方法。 方法一:使用 Spring Initializr Spring Initializr 是 Spring 官方提供的一个在线工具,用于快速生成 Spring Boot 项目。以下是在 IDEA 中使用...

    pit1_spring boot之 maven install 报错[Maven]1

    在Spring Boot项目中,`maven install` 是一个常见的构建步骤,它用于将项目打包成可部署的格式,如JAR或WAR,并将其安装到本地Maven仓库。然而,当出现错误 `[ERROR] Failed to execute goal org.springframework....

    Spring Boot简化你的Java开发.docx

    起步依赖是Spring Boot的一项关键特性,它实质上是一组依赖描述符,可以帮助开发者自动配置Spring应用程序中常见的依赖项。开发者只需在项目中声明这些依赖,Spring Boot就会自动完成相关的配置工作,大大减轻了...

    spring-boot-2.2.4.RELEASE.zip

    2. **起步依赖(Starter POMs)**:Spring Boot通过一系列的起步依赖POM,为常见的功能模块提供了开箱即用的配置,如Spring Data JPA、Spring Web、Spring Security等。 3. **内嵌服务器**:Spring Boot内置了...

    spring-boot-security

    《Spring Boot Security详解》 Spring Boot Security是Spring生态系统中的一个强大组件,专为简化Web应用程序的安全管理而设计。它提供了一种集中的方式来保护你的应用程序,包括认证、授权、会话管理以及防止常见...

    卫通星GPS定位器GT06协议socket通讯JAVA Spring Boot对接

    在IT行业中,GPS定位器与后台系统的数据交互是物联网(IoT)应用中的常见场景。本文将详细讨论如何使用卫通星GPS定位器GT06的通信协议,通过Socket进行数据传输,并结合Java与Spring Boot框架实现后台服务的对接。 ...

Global site tag (gtag.js) - Google Analytics