@ConditionalOnClass与@ConditionalOnBean注解区别及理解正确性咨询

你的核心理解完全正确，两个注解的判断边界、执行阶段有本质区别，只是实际使用中经常搭配出现在自动配置逻辑里，容易让人混淆判断维度。

• @ConditionalOnClass：纯类路径层面的检查，和Spring容器没有关系。
  它的执行时机非常早，在Spring Boot启动初期筛选待加载的自动配置类时就会执行判断，仅校验指定类的.class文件是否能被当前类加载器在classpath路径下找到，不会触发目标类的初始化，也完全不关心这个类后续会不会被注册为Spring Bean。举个最常见的场景：只要你在项目里引入了Jackson的依赖，哪怕你没写任何Jackson相关配置、也没手动注册过Jackson相关的Bean，@ConditionalOnClass(ObjectMapper.class)的判断都会直接成立。
• @ConditionalOnBean：纯Spring容器层面的检查，完全依赖BeanFactory的实时状态。
  它的执行时机在Bean定义注册阶段，会去当前上下文的BeanFactory中查询是否存在符合匹配规则（可以按类型、名称、类上注解等维度匹配）的Bean，只有查到已注册的匹配Bean时条件才会成立。这里有个非常容易踩的坑：这个注解的判断结果和Bean的注册顺序强相关，很多开发者在这里踩过坑——如果被检查的Bean注册顺序晚于当前配置类，哪怕后续这个Bean确实会被放进容器，判断时也会因为暂时查不到返回不匹配。

Spring Boot官方的自动配置逻辑里，两个注解基本是固定搭配使用的：

1. 先在自动配置类的类层级标注@ConditionalOnClass，先确认当前项目引入了对应功能的依赖包，避免后续加载类时抛出ClassNotFoundException；
2. 再在具体的@Bean方法上标注@ConditionalOnBean或@ConditionalOnMissingBean，根据容器中已有的Bean情况，决定是否注册框架提供的默认组件实现，保证用户自定义的Bean优先级更高。

内容的提问来源于stack exchange，提问作者Panda World