执行mvn clean package时@ConditionalOnBean注解类加载异常问题

这个问题的核心在于你对@ConditionalOnBean的生效时机理解有偏差——Spring的条件注解是在Bean定义阶段生效的，但类本身的加载发生在更早的类解析阶段。

当你执行mvn clean package时，Spring Boot的打包流程会触发上下文的初始化检查（尤其是测试环节），这时候JVM需要加载CondClass的字节码，而这个类里直接引用了org.springframework.messaging.MessagingException，但你没引入对应的依赖，类加载器找不到这个类就直接抛出ClassNotFoundException。这时候@ConditionalOnBean(MyConf.class)的条件判断还没来得及执行，因为类都没加载成功，根本到不了Bean定义的环节。

而手动测试正常，大概率是你的测试环境里间接引入了包含MessagingException的依赖，或者测试上下文的加载逻辑有差异，没触发这个类的加载。

解决办法 #

这里有几个可行的方案，你可以根据场景选择：

1. 添加类存在性的条件判断
   给CondClass额外加上@ConditionalOnClass(MessagingException.class)注解，这样Spring会先检查这个类是否能被加载，只有当MyConf的Bean存在且MessagingException类可被加载时，才会尝试加载CondClass：

   @Service
   @RequiredArgsConstructor
   @ConditionalOnBean(MyConf.class)
   @ConditionalOnClass(org.springframework.messaging.MessagingException.class)
   public class CondClass {
       // ... 你的方法
       public void method() throws org.springframework.messaging.MessagingException {
           // ...
       }
   }
   

2. 拆分依赖缺失的逻辑
   把依赖MessagingException的代码抽成独立类/组件，让CondClass通过依赖注入使用它，同时给这个独立组件也加上对应条件注解。这样即使CondClass被加载，只要依赖的组件因条件不满足没被创建，也不会触发缺失类的加载：

   // 抽离的消息处理组件
   @Component
   @ConditionalOnBean(MyConf.class)
   @ConditionalOnClass(MessagingException.class)
   public class MessagingHandler {
       public void doBusiness() throws MessagingException {
           // ... 具体逻辑
       }
   }
   
   // 原CondClass
   @Service
   @RequiredArgsConstructor
   @ConditionalOnBean(MyConf.class)
   public class CondClass {
       private final MessagingHandler messagingHandler;
   
       public void method() throws MessagingException {
           messagingHandler.doBusiness();
       }
   }
   

3. 将依赖设为可选
   如果确认在MyConf Bean存在的场景下，一定会引入MessagingException所在的依赖，可以在pom.xml里把这个依赖标记为可选：

   <dependency>
       <groupId>org.springframework</groupId>
       <artifactId>spring-messaging</artifactId>
       <version>你的对应版本</version>
       <optional>true</optional>
   </dependency>
   

   这样打包时不会强制引入该依赖，但运行时如果MyConf Bean存在，需要确保环境中存在这个依赖，否则还是会报错。

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