在 Spring Boot 中，@Bean 注解方法必须定义在被 @Configuration 标记的类中才能被容器识别并执行；若仅用 @Component（或其派生注解）修饰配置类，其中的 @Bean 方法将被忽略，导致初始化逻辑（如 MQ 消费者启动、资源预加载等）完全不触发。
在 spring boot 中，`@bean` 注解方法必须定义在被 `@configuration` 标记的类中才能被容器识别并执行；若仅用 `@component`（或其派生注解）修饰配置类，其中的 `@bean` 方法将被忽略，导致初始化逻辑（如 mq 消费者启动、资源预加载等）完全不触发。
Spring Boot 的 Bean 生命周期管理高度依赖类的元数据类型。@Bean 方法本质上是配置驱动的工厂方法，Spring 容器仅在明确标识为配置类（即标注 @Configuration）的类中扫描并代理执行这些方法——这是实现 @Bean 方法间依赖注入、CGLIB 增强（如避免重复创建单例）以及生命周期回调的前提。
而 @Component 及其衍生注解（如 @Service、@Repository）的作用是将普通组件类注册为 Spring Bean，其自身作为 Bean 实例被管理，但不会触发对其内部 @Bean 方法的解析与调用。因此，如下代码即使加了 @Component("example")，workClass() 方法也永远不会被执行：
@Component("example") // ❌ 错误：Component 不支持@Bean方法语义
public class Example {
@Bean
public WorkClass workClass(Example example) { // ← 此方法被完全忽略
example.exampleHandler.accept("Hello"); // ← 永远不会打印
return new WorkClass();
}
}✅ 正确做法是：使用 @Configuration 显式声明配置类，并可选地配合 @Component（通常无需）：
@Configuration // ✅ 必须添加：启用@Bean方法处理
public class ExampleConfig { // 类名建议体现配置意图，避免与业务类混淆
private final Consumer<String> exampleHandler = System.out::println;
@Bean
public WorkClass workClass() {
exampleHandler.accept("Hello"); // ✅ 现在会正常执行
return new WorkClass();
}
}对于真实项目中的 RocketMQ 消费者初始化场景，修正后应为：
@Configuration
public class MQConsumerConfig {
@Autowired
private CanalSyncConsumerConfig canalSyncConsumerConfig;
@Autowired
private MqProperties mqProperties; // 假设已通过@ConfigurationProperties绑定
@Bean(destroyMethod = "shutdown") // 建议显式声明销毁方法，确保优雅关闭
public DefaultMQPushConsumer canalSyncConsumer() throws MQClientException {
RPCHook rpcHook = new AclClientRPCHook(
new SessionCredentials(mqProperties.getAccessKey(), mqProperties.getSecretKey())
);
DefaultMQPushConsumer consumer = new DefaultMQPushConsumer(
null,
"GID_MEMBER_CENTER_CANAL_SYNC_GROUP",
rpcHook
);
consumer.setNamesrvAddr(mqProperties.getNamesAddr());
String subExpression = String.join("||", MONITOR_TABLE_NAMES);
consumer.subscribe("mq_data_mid_platform_sync", subExpression);
consumer.registerMessageListener(canalSyncConsumerConfig.consumerHandler);
consumer.start(); // ✅ 启动逻辑在此处可靠执行
return consumer;
}
}⚠️ 关键注意事项：
- @Configuration 类不能是 final 类（否则 CGLIB 无法代理），且推荐使用 public 访问修饰符；
- 避免在 @Configuration 类中使用 new 创建依赖对象（如 new DefaultMQPushConsumer(...)），应优先通过 @Bean 方法声明依赖，以便容器统一管理生命周期；
- 若需条件化加载 Bean（如根据 profile 或属性开关），应结合 @ConditionalOnProperty、@Profile 等条件注解，而非在 @Bean 方法体内硬编码判断；
- @Bean 方法的返回值会被 Spring 容器管理，默认为单例作用域（@Scope("singleton")），如需原型行为，需显式声明 @Scope("prototype")。
总结：@Bean 是 Spring 配置模型的核心契约，它只在 @Configuration 类上下文中生效。将 @Component 替换为 @Configuration 不仅解决方法不执行问题，更是回归 Spring 声明式配置的本质——让容器真正理解“你希望它创建什么”，而非“你写了什么”。
