SpringBoot 工程，不是所有的服务都引入了 spring-boot-starter-amqp 依赖，我应该使用什么条件注解，判断配置类是否生效

你应该使用 @ConditionalOnClass 注解。

这个注解是 Spring Boot 条件化配置的核心组件之一，它的作用是：只有当类路径（classpath）中存在指定的类时，被它标注的配置类或 @Bean 方法才会生效。

在你的场景中，因为并非所有服务都引入了 spring-boot-starter-amqp 依赖，直接编写配置会导致在缺少该依赖的服务中启动失败。通过 @ConditionalOnClass，你可以确保只有在引入了该依赖（即相关类存在于类路径上）的服务中，相关的 AMQP 配置才会被加载。

💡 如何使用 @ConditionalOnClass

通常，我们会选择一个在 spring-boot-starter-amqp 这个依赖中必然会存在、且具有代表性的类作为判断依据，例如 RabbitTemplate 或 ConnectionFactory。

1. 在配置类上使用

你可以将注解加在配置类上，这样整个配置类中的所有 @Bean 定义都会受到条件控制。

java 复制代码

import org.springframework.amqp.core.ConnectionFactory;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.context.annotation.Configuration;

@Configuration
// 当类路径下同时存在 ConnectionFactory 和 RabbitTemplate 时，该配置类才生效
@ConditionalOnClass({ConnectionFactory.class, RabbitTemplate.class})
public class AmqpConfiguration {
    
    // 在此配置类中的所有 Bean 都将只在 AMQP 依赖存在时被创建
    // ...
}

2. 在 Bean 方法上使用

如果你只想对某一个特定的 Bean 进行条件化控制，也可以将注解直接加在 @Bean 方法上。

java 复制代码

import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class AmqpConfiguration {

    // 仅当类路径下存在 RabbitTemplate 时，才创建 customRabbitTemplate 这个 Bean
    @Bean
    @ConditionalOnClass(RabbitTemplate.class)
    public CustomRabbitTemplate customRabbitTemplate() {
        return new CustomRabbitTemplate();
    }
}

📝 关键属性说明

@ConditionalOnClass 注解主要有两个属性来指定需要检查的类：

value : 接受一个 Class 类型的数组。这种方式类型安全，但如果在编译时目标类不存在，会导致编译失败。
name: 接受一个字符串类型的类全限定名数组。这种方式更灵活，可以避免编译时的依赖，Spring 会在运行时通过反射检查类是否存在。

对于你的场景，推荐使用 value 属性，因为在确实需要使用 AmqpConfiguration 的模块中，你必然会引入 spring-boot-starter-amqp 依赖，从而确保编译通过。