SpringBoot @EnableAutoConfiguration exclude属性失效

最新推荐文章于 2025-06-27 00:06:49 发布
最新推荐文章于 2025-06-27 00:06:49 发布
阅读量2.9w 收藏 11
点赞数
CC 4.0 BY-SA版权
分类专栏： java 文章标签： springboot
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/yuan_ren_sheng/article/details/81516779
探讨SpringBoot中@SpringBootApplication的@EnableAutoConfiguration注解的exclude属性失效原因，解析@ComponentScan与spring.factories文件在不同包下导致的问题及解决方法。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

在学习SpringBoot的时候，入了不少的坑。今天学习@SpringBootApplication里面的@EnableAutoConfiguration注解的exclude属性的，加载配置中，发现了属性失效的case

病状:exclude属性不起作用，如下:

根治:首先我们要知道exclude这个属性的使用说明，说明exclude就是说一下这个@EnableAutoConfiguration这个注解了

我们都知道这个注解(@EnableAutoConfiguration)是自动装配我们容器中的bean实例的，他会从你的<  classpath  >下的类中自动生成一些bean,并且加载到context中.

看重点了，他加载的是classpath下的Bean.我么看一下springboot的源码

看到SpringFactoriesLoader这个类会加载classpath下面的META-INF/spring.factories文件下面的所配置的所有bean

因为SpringBoot是一个全能框架，所以他的扩展方面也是很强的。我们使用springboot的时候必然是用maven.那么如果项目要引用第三方配置，或者classpath的配置。我么通过spring.factories文件就可以实现。下面是一个小case

两个maven项目springboot 是主要的项目。我们springboot这个项目引用dev这个项目里面的某个配置的时候。就需要将两个项目做关联。我们可以在springboot这个项目里面加入dev这个项目的maven坐标，如下:

boot里面引用dev的坐标之后两个项目就有所关联了，现在我们引用dev里面的配置。有两种结果

第一种:如果你的启动类和你引用的配置类在一个包底(包名一样或者在包的子包下)下，那么直接获取是没问题的因为有@ComponentScan这个注解

第二种:就是没在一个包下，@ComponentScan这个注解也没有扫描那个包。我们就可以通过spring.factory来配置。比如在dev这个项目中:如下:

内容是下面的这个截图同样是KEY-VALUE形式的

这里的名字不能更改的，不然不起作用，通过这样配置然后再在springboot中引用dev的配置就可以了。到这里应该就知道为什么exclude这个属性不生效了，因为他们没有在同一个包下面@ComponentScan这个注解做了自动扫描没有扫描到这里面的bean

加载spring.factories文件返回一个spring[]的数组会全部注入到spring ioc容器中。所以exclude这个属性是控制的spring.factories这个文件里面的注入ioc容器的bean...

 

完（）

Spring : @EnableAutoConfiguration注解
九师兄
01-19 764
1.美图 2.概述 @EnableAutoConfiguration注解使自动配置生效。用于帮助SpringBoot应用将所有符合条件的@SpringBootConfiguration、@Configuration配置加载到当前SpringBoot IOC容器里面去。 换句话说，想使用@SpringBootConfiguration、@Configuration就得一定得使用@EnableAut...
【Spring】exclude= {DataSourceAutoConfiguration.class} 失效 解决方案
九师兄
06-30 748
但是启动的时候仍然报错，有的人引入了这个druid，那么druid-spring-boot-starter 会再次扫描数据源。你需要排除这个DruidDataSourceAutoConfigure，但是我的没有。我有个Spring 程序，然后运行的时候，不想连接数据库，但是总是报错。这个居然是parent引入的。对应的maven设置如下。
spring boot EnableAutoConfiguration exclude 无效
天下无双
02-26 1万+
首先讲一下SpringBootApplication注解 源码定义为 @Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @Documented @Inherited @SpringBootConfiguration @EnableAutoConfiguration @ComponentScan(excludeFilter...
SpringBootApplication的exclude不生效问题排查
sutonline的博客
06-03 1万+
SpringBootApplication的exclude不生效问题排查 背景 在ManApplication上添加了SpringBootApplication中配置了exclude={org.springframework.boot.autoconfigure.data.elasticsearch.ElasticsearchAutoConfiguration.class} 但是在启动过程了ElasticsearchAutoConfiguration还是加载了，使用配置文件的方式就可以避免加载。 排查 首先
@EnableAutoConfiguration @SpringBootConfiguration @Configuration 详解及详细源码展示
最新发布
csdn_tom_168的博客
06-27 1012
Spring Boot 核心注解解析：@EnableAutoConfiguration 负责自动配置机制，通过 AutoConfigurationImportSelector 加载条件化配置；@SpringBootConfiguration 作为主配置类标识，继承 @Configuration 特性；@Configuration 定义显式配置类。三者协同工作：主类启动触发组件扫描，自动配置根据依赖加载对应 Bean，自定义配置类补充特定逻辑，共同完成应用上下文初始化。典型场景包括主类标注、自定义 Bean
Springboot项目使用@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})失效的解决方案
lovoo的博客
06-11 3675
前言 在微服务中，搭建的网关模块是不需要连接数据库资源的，但在公共模块mall-common中加入了druid数据库资源池，在启动application时，即使添加了(exclude = {DataSourceAutoConfiguration.class}也会报数据库连接的错误，如何彻底解决呢？ 项目结构图： 下载地址：https://gitee.com/charlinchenlin/wysmall 异常内容： *************************** APPLICATION FAILED
Spring boot项目中排除自动配置类失败问题始末
GAOXINXINGgaoxinxing的博客
08-03 5099
正常情况下，在Spring boot项目中，对于多个自动配置类冲突问题，使用@EnableAutoConfiguration的exclude即可。 如下，存在两个配置类构造同一dataSource： 1.某包下DruidDataSourceAutoConfigSelf配置类（使用spring.factories进行的自动配置） packagecom.example.framework.autoconfigure.druid; @Configuration @Con..
@SpringBootApplication(exclude ={DatasourceAutoConfiguration.class})失效
漫观天上云卷云舒的博客
12-06 2992
@SpringBootApplication(exclude ={DatasourceAutoConfiguration.class})失效 项目不加载数据源
@SpringBootApplication、@ComponentScan、@Entity的使用
xiaoQL520的博客
11-03 1477
1. @SpringBootApplication与@ComponentScan的关系 @SpringBootApplication = @Configuration + @EnableAutoConfiguration + @ComponentScan。 @Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @Documented @Inherited @SpringBootConfiguration @EnableAutoCon
深入解析SpringBoot核心运行原理和运作原理源码
m0_63437643的博客
02-25 1789
SpringBoot核心运行原理 Spring Boot 最核心的功能就是自动配置，第 1 章中我们已经提到，功能的实现都是基于“约定优于配置”的原则。那么 Spring Boot 是如何约定，又是如何实现自动配置功能的呢? 本章会带领大家通过源码学习 Spring Boot 的核心运作原理，内容涉及自动配置的运作原理、核心功能模块、核心注解以及使用到的核心源代码分析。 核心运行原理 使用 Spring Boot 时，我们只需引|入对应的 Starters, Spring Boot 启动时便会自动加
springboot 禁用mongoDB自动配置
08-23 1万+
一、问题背景 springboot 内置了mongoDB驱动，默认配置localhost：27017，若本机没有配置mongoDB，则会连接失败。 二、解决方案 1. 添加注解：@SpringBootApplication(exclude = {MongoAutoConfiguration.class,MongoDataAutoConfiguration.class}) /* *
[已解决] @SpringBootApplication(exclude = {DataSourceAutoConfiguration.class}) 失效
m0_73928224的博客
04-09 1250
@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class}) 失效
Spring Boot 排除自动配置
weixin_46812727的博客
07-21 3098
Spring Boot 排除自动配置
springboot排除某些自动配置
weixin_43522117的博客
08-13 1437
Spring Boot 提供的自动配置非常强大，某些情况下，自动配置的功能可能不符合我们的需求，需要我们自定义配置，这个时候就需要排除/禁用Spring Boot 某些类的自动化配置了。比如:数据源、邮件，这些都是提供了自动配置的，我们需要排排除 Spring Boot 的自动化配置交给我们自己来自定义，该如何做呢?
SpringBoot项目使用了@EnableAutoConfiguration 注解报错：The Bean Validation API is on the classpath but no impl
热门推荐
青山师
07-12 1万+
构建简单的SpringBoot项目时，在启动项目的时候发现如下错误： Description: The Bean Validation API is on the classpath but no implementation could be found Action: Add an implementation, such as Hibernate Validator, to the ...
聊聊SpringBoot中的@EnableAutoConfiguration注解
troopzhang的专栏
08-25 1145
引言 @Target({ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) @Documented @Inherited @AutoConfigurationPackage @Import({AutoConfigurationImportSelector.class}) public @interface EnableAutoConfiguration { String ENABLED_OVERRIDE_PROPERTY = "sprin
SpringBoot-自动配置原理详解
高高冷的博客
11-13 326
一、什么是自动装配 SpringBoot 定义了一套接口规范，这套规范规定：SpringBoot 在启动时会扫描外部引用 jar 包中的META-INF/spring.factories文件，将文件中配置的类型信息加载到 Spring 容器（此处涉及到 JVM 类加载机制与 Spring 的容器知识），并执行类中定义的各种操作。对于外部 jar 来说，只需要按照 SpringBoot 定义的标准，就能将自己的功能装置进 SpringBoot。 记住这个spring.factories文件，我们在下面自定义s
springboot无数据库启动
穹顶之下
11-09 890
在Application类上 @SpringBootApplication(exclude = { DataSourceAutoConfiguration.class, DataSourceTransactionManagerAutoConfiguration.class, HibernateJpaAutoConfiguration.class}) 实际上只需要 @SpringBootApplication(exclude={DataSourceAutoConfiguration.class}) 即
springboot启动不加载数据源
03-18
<think>好的，我现在需要解决用户的问题：Spring Boot启动时未加载数据源。用户提供的引用内容中，引用了Spring Boot和Spring Cloud的版本信息，以及一些配置示例，但可能没有直接关于数据源的配置。不过，我可以根据常见的解决步骤来思考。 首先，用户提到使用的是Spring Boot 2.2.2.RELEASE和Spring Cloud Hoxton.SR12。这可能涉及依赖管理的问题。例如，是否引入了正确的数据源依赖，比如spring-boot-starter-data-jpa或spring-boot-starter-jdbc。如果没有正确配置，Spring Boot可能不会自动配置数据源。 接下来，用户提供的引用中有关于配置文件的内容，比如开发环境的配置和激活的profile。这提示我需要检查application.properties或application.yml中的配置是否正确。例如，数据库URL、用户名、密码是否正确，数据源相关的属性如spring.datasource.url是否拼写正确。此外，是否有多个配置文件导致配置被覆盖或未生效？比如，是否在application-dev.properties中配置了数据源，但没有激活对应的profile。 另一个可能性是数据源配置被Spring Cloud的某些组件覆盖了。例如，如果使用了服务发现或者配置中心，可能需要检查是否在配置中心中有错误的数据源配置，或者配置未被正确加载。用户提到的引用[1]提到重新创建工程，可能存在依赖缺失或版本冲突，导致自动配置失败。 此外，用户可能没有在启动类上添加必要的注解，比如@SpringBootApplication，或者排除了数据源相关的自动配置类。例如，如果使用了@EnableAutoConfiguration(exclude = {DataSourceAutoConfiguration.class})，就会禁用数据源的自动配置。 还有，数据库驱动的问题。例如，MySQL的驱动类是否正确，是否在pom.xml或build.gradle中添加了对应的驱动依赖，并且版本与数据库兼容。比如，MySQL 8.x需要使用com.mysql.cj.jdbc.Driver，并且连接URL需要指定时区参数。 最后，查看启动日志中的错误信息是关键。例如，是否有“Failed to configure a DataSource”这样的错误，提示找不到合适的驱动类，或者连接被拒绝。根据日志中的异常堆栈，可以更准确地定位问题。 总结可能的解决步骤： 1. 检查依赖是否正确添加。 2. 验证配置文件中的数据库连接信息。 3. 确保没有排除数据源自动配置。 4. 检查数据库驱动是否正确配置。 5. 查看启动日志以获取具体错误信息。</think>### Spring Boot启动时未加载数据源的解决方案 #### 1. 检查数据源依赖 确保项目中已添加数据库驱动和Spring Boot数据源依赖： ```xml <!-- MySQL驱动示例 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.28</version> </dependency> <!-- JDBC Starter --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-jdbc</artifactId> </dependency> ``` 若使用JPA，需包含`spring-boot-starter-data-jpa`。未正确引入依赖会导致自动配置失败[^1]。 #### 2. 验证数据源配置 检查`application.properties`或`application.yml`中的配置： ```properties # MySQL示例（注意时区参数） spring.datasource.url=jdbc:mysql://localhost:3306/mydb?serverTimezone=UTC spring.datasource.username=root spring.datasource.password=123456 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver ``` - 确认配置文件位于`src/main/resources` - 确保未使用错误的Profile配置（如未激活的`application-dev.properties`）[^2] #### 3. 检查自动配置排除 在启动类中，确保未排除数据源自动配置： ```java // 错误示例：手动排除会导致数据源失效 @SpringBootApplication(exclude = {DataSourceAutoConfiguration.class}) ``` 移除`exclude`参数或检查是否有其他配置干扰。 #### 4. 数据库驱动兼容性 - MySQL 8.x需使用`com.mysql.cj.jdbc.Driver`而非旧版`com.mysql.jdbc.Driver` - 检查驱动版本与数据库版本匹配（如MySQL 5.7与8.x驱动不兼容） #### 5. 分析启动日志 查看控制台输出的错误类型： - **"Failed to configure a DataSource"**：通常表示配置缺失或依赖未引入 - **"Connection refused"**：数据库服务未启动或网络不通 - **"Access denied"**：用户名/密码错误 #### 6. 多数据源配置问题 若配置了多个数据源，需通过`@Primary`注解指定主数据源： ```java @Bean @Primary @ConfigurationProperties("spring.datasource.primary") public DataSource primaryDataSource() { return DataSourceBuilder.create().build(); } ``` #### 7. 版本冲突检查 确认Spring Boot与Spring Cloud版本兼容（如用户使用的Hoxton.SR12对应Boot 2.2.x~2.3.x[^1]），通过`mvn dependency:tree`排查依赖冲突。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值