一、什么是自动配置1. 定义自动配置Spring Boot 根据项目中的依赖和配置自动装配所需的 Bean减少手动配置的工作量。2. 对比传统 Spring vs Spring Boot传统 Spring 配置繁琐Configuration public class DataSourceConfig { Bean public DataSource dataSource() { DriverManagerDataSource dataSource new DriverManagerDataSource(); dataSource.setDriverClassName(com.mysql.cj.jdbc.Driver); dataSource.setUrl(jdbc:mysql://localhost:3306/mydb); dataSource.setUsername(root); dataSource.setPassword(password); return dataSource; } Bean public JdbcTemplate jdbcTemplate(DataSource dataSource) { return new JdbcTemplate(dataSource); } Bean public LocalContainerEntityManagerFactoryBean entityManagerFactory( DataSource dataSource) { LocalContainerEntityManagerFactoryBean factory new LocalContainerEntityManagerFactoryBean(); factory.setDataSource(dataSource); factory.setPackagesToScan(com.example.myapp.model); factory.setJpaVendorAdapter(new HibernateJpaVendorAdapter()); return factory; } Bean public PlatformTransactionManager transactionManager( EntityManagerFactory entityManagerFactory) { return new JpaTransactionManager(entityManagerFactory); } }Spring Boot 自动配置简洁只需要一个依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-jpa/artifactId /dependency配置文件application.propertiesspring.datasource.urljdbc:mysql://localhost:3306/mydb spring.datasource.usernameroot spring.datasource.passwordpassword自动配置完成无需写任何 Java 配置代码。3. 自动配置的核心价值传统 SpringSpring Boot手动创建 Bean自动创建 Bean大量重复配置约定优于配置配置分散配置集中学习成本高快速上手二、自动配置的工作原理1. 核心流程图启动应用 (SpringBootApplication) ↓ 扫描 classpath 下的依赖 ↓ 加载自动配置类 (META-INF/spring.factories 或 spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports) ↓ 根据条件注解 (Conditional) 决定是否创建 Bean ↓ 应用用户自定义配置 ↓ 完成 Bean 装配2. SpringBootApplication 注解SpringBootApplication public class MyApplication { public static void main(String[] args) { SpringApplication.run(MyApplication.class, args); } }SpringBootApplication 是一个组合注解SpringBootConfiguration // 标记为配置类 EnableAutoConfiguration // 启用自动配置核心 ComponentScan // 扫描组件Component、Service 等 public interface SpringBootApplication { // ... }3. EnableAutoConfiguration 注解Import(AutoConfigurationImportSelector.class) // 导入自动配置选择器 public interface EnableAutoConfiguration { // ... }AutoConfigurationImportSelector的工作读取META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports加载所有自动配置类根据条件注解过滤不需要的配置4. 自动配置类的发现机制Spring Boot 2.7 之前文件位置META-INF/spring.factories# Auto Configure org.springframework.boot.autoconfigure.EnableAutoConfiguration\ org.springframework.boot.autoconfigure.admin.SpringApplicationAdminJmxAutoConfiguration,\ org.springframework.boot.autoconfigure.aop.AopAutoConfiguration,\ org.springframework.boot.autoconfigure.amqp.RabbitAutoConfiguration,\ org.springframework.boot.autoconfigure.batch.BatchAutoConfiguration,\ org.springframework.boot.autoconfigure.cache.CacheAutoConfiguration,\ org.springframework.boot.autoconfigure.cassandra.CassandraAutoConfiguration,\ ...Spring Boot 2.7 及之后文件位置META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.importsorg.springframework.boot.autoconfigure.admin.SpringApplicationAdminJmxAutoConfiguration org.springframework.boot.autoconfigure.aop.AopAutoConfiguration org.springframework.boot.autoconfigure.amqp.RabbitAutoConfiguration org.springframework.boot.autoconfigure.batch.BatchAutoConfiguration org.springframework.boot.autoconfigure.cache.CacheAutoConfiguration ...三、条件注解Conditional1. 什么是条件注解条件注解根据特定条件决定是否创建 Bean 或加载配置。2. 常用条件注解注解作用示例ConditionalOnClassclasspath 中存在指定类时生效ConditionalOnClass(DataSource.class)ConditionalOnMissingClassclasspath 中不存在指定类时生效ConditionalOnMissingClass(RedisTemplate.class)ConditionalOnBeanSpring 容器中存在指定 Bean 时生效ConditionalOnBean(DataSource.class)ConditionalOnMissingBeanSpring 容器中不存在指定 Bean 时生效ConditionalOnMissingBean(DataSource.class)ConditionalOnProperty配置文件中满足指定属性时生效ConditionalOnProperty(nameapp.cache.enabled, havingValuetrue)ConditionalOnResource存在指定资源文件时生效ConditionalOnResource(resourcesclasspath:application.properties)ConditionalOnWebApplication是 Web 应用时生效ConditionalOnWebApplicationConditionalOnNotWebApplication不是 Web 应用时生效ConditionalOnNotWebApplication3. 条件注解示例示例 1ConditionalOnClass场景只有引入 MySQL 驱动时才创建 DataSourceConfiguration ConditionalOnClass(DataSource.class) // classpath 中存在 DataSource 类 public class DataSourceAutoConfiguration { Bean ConditionalOnMissingBean // 用户没有自定义 DataSource public DataSource dataSource() { // 创建默认 DataSource return new DriverManagerDataSource(); } }示例 2ConditionalOnProperty场景根据配置决定是否启用缓存Configuration ConditionalOnProperty( prefix cache, // 配置前缀 name enabled, // 配置名称 havingValue true, // 匹配的值 matchIfMissing false // 默认不启用 ) public class CacheAutoConfiguration { Bean public CacheManager cacheManager() { // 创建缓存管理器 return new ConcurrentMapCacheManager(); } }配置文件cache.enabledtrue # 启用缓存示例 3ConditionalOnBean场景只有 DataSource 存在时才创建 JdbcTemplateConfiguration public class JdbcTemplateAutoConfiguration { Bean ConditionalOnBean(DataSource.class) // DataSource 存在时才创建 public JdbcTemplate jdbcTemplate(DataSource dataSource) { return new JdbcTemplate(dataSource); } }示例 4ConditionalOnMissingBean场景用户没有自定义时使用默认实现Configuration public class MyServiceAutoConfiguration { Bean ConditionalOnMissingBean(MyService.class) // 用户没有自定义 MyService public MyService myService() { // 返回默认实现 return new DefaultMyService(); } }用户自定义实现Configuration public class CustomConfig { Bean public MyService myService() { // 自定义实现优先级高于默认实现 return new CustomMyService(); } }四、DataSource 自动配置案例分析1. 自动配置类Configuration(proxyBeanMethods false) ConditionalOnClass(DataSource.class) // classpath 中存在 DataSource 类 ConditionalOnMissingBean(DataSource.class) // 用户没有自定义 DataSource EnableConfigurationProperties(DataSourceProperties.class) // 绑定配置属性 Import(DataSourcePoolMetadataProvidersConfiguration.class) AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE) public class DataSourceAutoConfiguration { // 嵌入式数据库配置H2 Configuration(proxyBeanMethods false) Conditional(EmbeddedDatabaseCondition.class) ConditionalOnMissingBean(DataSource.class) Import(EmbeddedDataSourceConfiguration.class) protected static class EmbeddedDatabaseConfiguration { } // 池化数据源配置HikariCP、Tomcat、Dbcp2 Configuration(proxyBeanMethods false) Conditional(PooledDataSourceCondition.class) ConditionalOnMissingBean(DataSource.class) Import({ DataSourceConfiguration.Hikari.class, DataSourceConfiguration.Tomcat.class, DataSourceConfiguration.Dbcp2.class, DataSourceConfiguration.OracleUcp.class, DataSourceConfiguration.Generic.class }) protected static class PooledDataSourceConfiguration { } }2. 配置属性绑定DataSourceProperties.javaConfigurationProperties(prefix spring.datasource) // 绑定 spring.datasource.* 配置 public class DataSourceProperties { private String url; private String username; private String password; private String driverClassName; // getter/setter }配置文件spring.datasource.urljdbc:mysql://localhost:3306/mydb spring.datasource.usernameroot spring.datasource.passwordpassword spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver3. HikariCP 自动配置Configuration(proxyBeanMethods false) ConditionalOnClass(HikariDataSource.class) // classpath 中存在 HikariDataSource ConditionalOnMissingBean(DataSource.class) // 用户没有自定义 DataSource ConditionalOnProperty(name spring.datasource.type, havingValue com.zaxxer.hikari.HikariDataSource, matchIfMissing true) static class Hikari { Bean HikariDataSource dataSource(DataSourceProperties properties) { // 创建 HikariDataSource return createDataSource(properties, HikariDataSource.class); } }五、自动配置优先级1. 配置优先级从高到低1. Bean 方法中的显式配置 2. application-{profile}.properties/yml 3. application.properties/yml 4. 自动配置类的默认值2. 示例DataSource 配置优先级场景 1用户显式配置最高优先级Configuration public class CustomDataSourceConfig { Bean public DataSource dataSource() { // 用户自定义 DataSource优先级最高 return new CustomDataSource(); } }场景 2配置文件# application.properties spring.datasource.urljdbc:mysql://localhost:3306/customdb spring.datasource.usernameadmin spring.datasource.passwordsecret场景 3自动配置最低优先级Configuration ConditionalOnMissingBean(DataSource.class) // 用户没有配置时才生效 public class DataSourceAutoConfiguration { Bean public DataSource dataSource() { // 自动配置的默认值 return new DriverManagerDataSource(); } }六、自定义自动配置1. 创建自动配置类MyServiceAutoConfiguration.javaConfiguration ConditionalOnClass(MyService.class) // classpath 中存在 MyService EnableConfigurationProperties(MyServiceProperties.class) // 绑定配置 public class MyServiceAutoConfiguration { Bean ConditionalOnMissingBean(MyService.class) // 用户没有自定义时才创建 public MyService myService(MyServiceProperties properties) { MyService service new MyService(); service.setEnabled(properties.isEnabled()); service.setCacheSize(properties.getCacheSize()); return service; } }2. 创建配置属性类MyServiceProperties.javaConfigurationProperties(prefix myapp.service) // 绑定 myapp.service.* 配置 public class MyServiceProperties { private boolean enabled true; // 默认启用 private int cacheSize 100; // 默认缓存大小 // getter/setter }3. 注册自动配置文件位置META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.importscom.example.myapp.autoconfigure.MyServiceAutoConfiguration4. 使用自定义自动配置配置文件myapp.service.enabledtrue myapp.service.cache-size200代码中使用Service public class UserService { Autowired private MyService myService; // 自动注入 public void doSomething() { if (myService.isEnabled()) { // 使用 MyService } } }七、禁用自动配置1. 全局禁用自动配置SpringBootApplication(exclude { DataSourceAutoConfiguration.class, // 禁用 DataSource 自动配置 RedisAutoConfiguration.class // 禁用 Redis 自动配置 }) public class MyApplication { public static void main(String[] args) { SpringApplication.run(MyApplication.class, args); } }2. 通过配置文件禁用application.propertiesspring.autoconfigure.exclude\ org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration,\ org.springframework.boot.autoconfigure.data.redis.RedisAutoConfiguration3. 条件禁用通过条件注解myapp.cache.enabledfalse # 禁用缓存自动配置八、调试自动配置1. 启用调试模式application.propertiesdebugtrue启动日志输出 CONDITIONS EVALUATION REPORT Positive matches: # 满足条件的自动配置 ----------------- DataSourceAutoConfiguration matched: - ConditionalOnClass found required class javax.sql.DataSource (OnClassCondition) MyServiceAutoConfiguration matched: - ConditionalOnClass found required class com.example.MyService (OnClassCondition) Negative matches: # 不满足条件的自动配置 ----------------- RedisAutoConfiguration did not match: - ConditionalOnClass did not find required class org.springframework.data.redis.connection.RedisConnectionFactory (OnClassCondition) Exclusions: # 手动排除的自动配置 ----------- None Unconditional classes: # 无条件自动配置 ---------------------- org.springframework.boot.autoconfigure.context.PropertyPlaceholderAutoConfiguration2. 使用 Actuator 查看自动配置添加依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-actuator/artifactId /dependency配置文件management.endpoints.web.exposure.include*访问自动配置报告curl http://localhost:8080/actuator/conditions3. 使用 IDE 查看自动配置IntelliJ IDEA打开Run/Debug Configurations勾选Enable launch optimization启动应用后在控制台查看自动配置报告九、最佳实践1. 理解约定优于配置约定说明默认端口8080配置文件application.properties/yml静态资源目录src/main/resources/static模板目录src/main/resources/templates测试目录src/test/java2. 合理使用自动配置场景建议快速开发使用自动配置定制化需求自定义配置优先级高于自动配置不需要的功能禁用自动配置学习调试启用 debug 模式3. 避免过度依赖自动配置问题不了解底层原理遇到问题难以排查定制化需求无法满足解决方案理解自动配置原理使用 debug 模式调试必要时自定义配置十、总结概念说明自动配置根据依赖和配置自动装配 BeanSpringBootApplication组合注解SpringBootConfiguration EnableAutoConfiguration ComponentScan条件注解根据条件决定是否加载配置ConditionalOnClass、ConditionalOnProperty 等配置优先级Bean application-{profile} application 自动配置禁用自动配置SpringBootApplication(exclude {...}) 或 spring.autoconfigure.exclude调试自动配置debugtrue 或 Actuator /actuator/conditions