springboot自动配置原理是三步机制：第一步由@springbootapplication中的@enableautoconfiguration触发；第二步通过autoconfigurationimportselector加载meta-inf/spring/org.springframework.boot.autoconfigure.autoconfiguration.imports中定义的配置类；第三步依据@conditional系列注解条件评估决定是否注册bean。
SpringBoot自动配置原理新手最常问的几个问题一次说清：为什么加了spring-boot-starter-web就自动起了Tomcat？为什么我写了DataSource却报Bean重复定义？为什么明明引入了JPA依赖，EntityManager却没创建出来？这些问题背后不是魔法，而是可追溯、可调试、可干预的三步机制。
自动配置到底从哪开始触发
第一步：启动类上必须有【@SpringBootApplication】注解，它不是装饰用的，而是实际激活自动配置的开关。这个注解本身是个组合注解，真正起作用的是其中的@EnableAutoConfiguration。
第二步：@EnableAutoConfiguration通过@Import(AutoConfigurationImportSelector.class)导入一个选择器，该选择器在应用上下文刷新前扫描所有jar包里的META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件（SpringBoot 2.7+）或spring.factories（旧版），把里面列出的全限定名自动配置类全部加载进来。
第三步：这些配置类被注册为候选BeanDefinition，但不会立刻实例化——它们要排队等待条件注解审核放行。
哪些自动配置类会被真正加载
方法一：看日志最直接。启动时加上参数--debug或配置logging.level.org.springframework.boot.autoconfigure=DEBUG，控制台会输出ConditionEvaluationReport，明确告诉你每个自动配置类“匹配了什么”“跳过了什么”“因为哪个条件不满足”。比如DataSourceAutoConfiguration会因@ConditionalOnClass(DataSource.class)失败而跳过——说明你根本没引入jdbc驱动。
方法二：手动排除干扰项。如果怀疑某个自动配置捣乱，直接在@SpringBootApplication里写exclude参数：
```java
@SpringBootApplication(exclude = {RedisAutoConfiguration.class})
```
这比删依赖更安全，也不影响其他功能。
方法三：检查依赖是否带全。spring-boot-starter-data-jpa本身不包含HikariCP，如果你没显式引入hikari-cp或tomcat-jdbc，@ConditionalOnClass(HikariDataSource.class)就会判定失败，整个DataSourceAutoConfiguration被跳过——【starter只声明能力，不打包实现】。
为什么我的Bean和自动配置冲突了
第一步：确认冲突来源。启动报BeanDefinitionOverrideException，说明容器里已经存在同类型、同名称的Bean。常见情况是：你自己写了@Bean DataSource方法，又没加@Primary；或者第三方starter悄悄注入了同名Bean。
第二步：用@Primary明确优先级。在你自定义的Bean上加@Primary，Spring会优先使用它，自动配置类里的同名Bean会被@ConditionalOnMissingBean拦截掉——这是官方推荐的解法，不是绕开机制，而是参与机制。
第三步：不要临时开覆盖开关。spring.main.allow-bean-definition-overriding=true只是让启动不报错，但后续运行时可能用错Bean，尤其在多环境部署时极易埋雷。
自动配置的Bean属性值从哪来
自动配置类本身不硬编码端口、URL、用户名这些值，而是通过@ConfigurationProperties绑定到application.properties或application.yml中对应前缀的配置项。比如ServerProperties绑定server.port、server.servlet.context-path。
注意：@ConfigurationProperties类必须被@EnableConfigurationProperties注解启用，否则绑定无效。SpringBoot默认已启用常用Properties类，但如果你自己写了一个XxxProperties，就必须手动加@EnableConfigurationProperties(XxxProperties.class)。
这一步操作起来很简单，直接把文件拖进去就行。但漏掉@EnableConfigurationProperties会导致属性始终是默认值，调试时容易误判为自动配置没生效。
