spring boot自动配置bean覆盖与排除的核心在于@conditional系列注解逻辑、@primary优先级、自定义bean声明时机及spring.autoconfigure.exclude等显式控制；排查关键是从auto-configuration report日志入手，确认配置类是否matched、did not match或excluded，并结合/actuator/beans端点验证实际注册状态。
Spring Boot 的自动配置类中 Bean 的覆盖与排除规则，核心在于理解 @Conditional 系列注解的生效逻辑、@Primary 优先级、自定义 Bean 的声明时机，以及 spring.autoconfigure.exclude 等显式控制手段。排查的关键不是“有没有被创建”，而是“为什么这个 Bean 没生效”或“为什么我的 Bean 被替换了”。
看清楚自动配置类是否真的被加载了
Spring Boot 启动时会打印类似 Auto-configuration report 的日志（需开启 debug=true 或 logging.level.org.springframework.boot.autoconfigure=DEBUG）。该报告会明确列出：
- 哪些自动配置类 matched（条件满足，已加载）
- 哪些 did not match（条件不满足，跳过），并附上具体原因（如
@ConditionalOnMissingBean不通过、类路径缺失等） - 哪些被
excluded（通过@EnableAutoConfiguration(exclude=...)或配置项排除）
这是最直接的入口。如果某个自动配置类没出现在 matched 列表里，先查它的 @Conditional* 条件是否被破坏，而不是急着改自己的 Bean。
检查你的自定义 Bean 是否触发了 @ConditionalOnMissingBean
绝大多数 Spring Boot 自动配置都用 @ConditionalOnMissingBean 防止覆盖。它默认只检查 当前容器中尚未注册同类型、同名称、同限定符的 Bean。注意几个关键细节：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
类型匹配是宽松的：接口、父类、泛型擦除后一致都算匹配。比如自动配置注册了
RedisTemplate<string string></string>，你声明了RedisTemplate（无泛型），仍会被视为存在，导致自动配置跳过 -
name 和 type 同时校验：若自动配置定义了
@Bean(name="myRedisTemplate")，而你声明了@Bean RedisTemplate otherRedisTemplate()（name 默认为方法名），则不冲突，两者都存在 —— 但可能引发依赖注入歧义 -
作用域影响判断：
@ConditionalOnMissingBean默认只检查 singleton scope。如果你的 Bean 是@Scope("prototype")，它不会阻止自动配置创建 singleton Bean
确认 @Primary、@Qualifier 和依赖注入点的实际行为
即使自动配置和自定义 Bean 都存在，最终注入哪个，取决于依赖方如何声明：
- 只用
@Autowired+ 类型注入？Spring 选@Primary标记的那个（若多个候选且无@Primary，抛异常） - 用
@Autowired @Qualifier("xxx")？那就严格按 name 匹配，和@Primary无关 - 构造器注入多个同类型 Bean？必须显式用
@Qualifier或参数名匹配（需开启spring.main.allow-bean-definition-overriding=true并确保名字唯一）
常见误区：以为加了 @Primary 就“覆盖”了自动配置 Bean —— 实际上它只是影响注入选择，两个 Bean 依然共存于容器中。
用 Actuator 的 /actuator/beans 端点验证最终容器状态
添加 spring-boot-starter-actuator 并暴露 beans 端点（management.endpoints.web.exposure.include=beans），访问 http://localhost:8080/actuator/beans 可看到：
- 所有已注册 Bean 的 name、type、scope、resource（来自哪个配置类或文件）
- 明确标注是否为 “auto-generated”（来自自动配置）或 “user-defined”
- 如果有同名 Bean，会显示 “overridden” 状态（仅当
spring.main.allow-bean-definition-overriding=true且后注册的覆盖了先注册的）
这是验证“实际结果”的黄金标准。比如发现 dataSource Bean 的 resource 是 DataSourceConfiguration$Hikari，说明 Hikari 自动配置生效；若是你自己的 @Configuration 类，则说明被你覆盖了。
spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.data.redis.RedisAutoConfiguration，比靠 @ConditionalOnMissingBean 更清晰可控。Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
