我要评论本文聚焦 springboot 自动配置排除的核心知识点，涵盖基础认知、5种实战排除方式、高频场景、排错技巧及面试考点，精简冗余内容，保留实战与面试核心，复制可用、易懂好记。
一、自动配置核心逻辑
1. 自动配置本质
springboot “开箱即用” 依赖自动配置：引入 starter 依赖（如 web、redis），启动时自动加载对应配置类、创建 bean，无需手动配置。核心载体是 spring-boot-autoconfigure 依赖中的自动配置类（如redisautoconfiguration）。
2. 自动配置触发条件
1. 依赖存在：对应 starter 或自动配置类所在 jar 包已加载；
2. 条件匹配：自动配置类上的 @conditional 系列注解（如 @conditionalonclass）匹配成功。
3. 为什么需要排除自动配置？
依赖传递导致多余加载、自定义 bean 冲突、多环境轻量化启动、第三方 starter 冲突、自定义 starter 开发，避免项目启动报错、资源浪费。
二、5种排除自动配置方式
方式1：@springbootapplication(exclude)
直接在启动类注解中指定排除的自动配置类（class 对象），适合固定排除少量配置。
@springbootapplication(exclude = {
datasourceautoconfiguration.class, // 排除数据源配置
redisautoconfiguration.class // 排除redis配置
})
public class application {
public static void main(string[] args) {
springapplication.run(application.class, args);
}
}注意：全局生效，需确保配置类可导入，不支持多环境。
方式2：@springbootapplication(excludename)
用全类名字符串指定排除类，适配包权限限制、版本变更过渡场景。
@springbootapplication(excludename = {
"org.springframework.boot.autoconfigure.jdbc.datasourceautoconfiguration"
})
public class application {
public static void main(string[] args) {
springapplication.run(application.class, args);
}
}注意：全类名需拼写正确，不推荐常规使用。
方式3：配置文件排除
通过 yml/properties 配置，支持多环境动态切换，无需修改代码，微服务首选。
# application.yml（推荐）
spring:
autoconfigure:
exclude:
- org.springframework.boot.autoconfigure.jdbc.datasourceautoconfiguration
- org.springframework.boot.autoconfigure.data.redis.redisautoconfiguration多环境配置：分别在 application-dev.yml、application-prod.yml 中配置，启动时指定环境（--spring.profiles.active=dev）。
方式4：@enableautoconfiguration(exclude)
@springbootapplication 底层注解，适合非标准启动类、自定义配置扩展。
@configuration
@componentscan(basepackages = "com.example.demo")
@enableautoconfiguration(exclude = datasourceautoconfiguration.class)
public class myconfig {
// 自定义bean配置
}方式5：autoconfigure.exclude 文件
springboot 2.0+ 支持，全局统一排除，适合自定义 starter、多模块统一配置。
操作：resources/meta-inf/spring/ 下创建 autoconfigure.exclude 文件，一行一个全类名。
org.springframework.boot.autoconfigure.jdbc.datasourceautoconfiguration org.springframework.boot.autoconfigure.data.redis.redisautoconfiguration
三、5种方式对比
| 排除方式 | 优先级 | 核心优点 | 适用场景 |
| @springbootapplication(exclude) | 最高 | 简单直观、精准 | 普通项目、固定排除 |
| @springbootapplication(excludename) | 最高 | 无需导入class | 无法导入class场景 |
| 配置文件排除 | 中 | 支持多环境、灵活 | 微服务、多环境 |
| @enableautoconfiguration(exclude) | 最高 | 底层扩展 | 非标准启动类 |
| autoconfigure.exclude 文件 | 最低 | 全局统一 | 自定义starter |
四、实战排除清单
1. 非web服务（排除tomcat）
@springbootapplication(exclude = {
servletwebserverfactoryautoconfiguration.class,
webmvcautoconfiguration.class
})2. 排除数据库配置（解决数据源报错）
@springbootapplication(exclude = {
datasourceautoconfiguration.class,
datasourcetransactionmanagerautoconfiguration.class
})3. 排除redis配置（自定义redistemplate）
@springbootapplication(exclude = {
redisautoconfiguration.class,
redisrepositoriesautoconfiguration.class
})五、常见问题
1. 排除失败
原因：全类名拼写错误、排除类不正确、依赖传递、优先级问题；
技巧：添加 debug=true 查看自动配置报告，核对全类名和依赖树。
2. 配置文件排除不生效
原因：路径/文件名错误、未指定环境、注解覆盖；
技巧：确认配置文件加载日志，去掉注解排除测试。
3. 排除后bean不存在报错
原因：排除了依赖bean的自动配置类；
技巧：保留必要配置类或删除依赖该bean的代码。
总结
springboot 自动配置排除，看似简单，却是解决项目启动报错、避免bean冲突的核心技巧，也是面试高频考点。
其实不用死记硬背，记住两个核心场景就够：普通项目用 @springbootapplication(exclude)，微服务多环境用配置文件排除，剩下的场景按需选择即可。
以上就是springboot自动配置排除的五种方式的详细内容，更多关于springboot自动配置排除的资料请关注代码网其它相关文章！
发表评论