Spring Boot 3.x.x迁移：@Bean注解autowire参数报错解决

问题原因 #

Spring Boot 3.x 基于 Spring Framework 6.x，该版本彻底移除了@Bean注解的autowire属性（该属性在Spring 5.x已被废弃），所以原代码中@Bean(autowire = Autowire.BY_TYPE)的写法会直接报错，修改为@Bean(Autowire.BY_TYPE)也不兼容——因为@Bean的参数已变为String类型的别名数组。

正确迁移方案 #

推荐使用构造函数注入替代原有的autowire配置，这也是Spring官方推荐的依赖注入方式，更清晰且符合最佳实践。

步骤1：调整目标类的构造函数 #

确保KafkaMessageConsumer通过构造函数声明需要注入的依赖（如果有）：

public class KafkaMessageConsumer implements MessageConsumer {
    // 示例依赖：假设需要注入KafkaTemplate
    private final KafkaTemplate<String, Object> kafkaTemplate;

    // 构造函数注入依赖，Spring会自动匹配并装配
    public KafkaMessageConsumer(KafkaTemplate<String, Object> kafkaTemplate) {
        this.kafkaTemplate = kafkaTemplate;
    }

    // 其他业务方法...
}

步骤2：修改配置类的@Bean方法 #

移除autowire属性，直接在@Bean方法的参数中声明依赖，Spring会自动按类型注入：

@Configuration
public class MessageConfiguration {

    @Scope(BeanDefinition.SCOPE_PROTOTYPE)
    @Bean
    MessageConsumer getMessageConsumer(KafkaTemplate<String, Object> kafkaTemplate) {
        return new KafkaMessageConsumer(kafkaTemplate);
    }
}

特殊情况：无依赖的场景 #

如果KafkaMessageConsumer不需要任何依赖，直接简化为：

@Configuration
public class MessageConfiguration {

    @Scope(BeanDefinition.SCOPE_PROTOTYPE)
    @Bean
    MessageConsumer getMessageConsumer() {
        return new KafkaMessageConsumer();
    }
}

补充说明 #

如果一定要实现类似原Autowire.BY_TYPE的手动装配逻辑（不推荐，违背Spring依赖注入设计理念），可以通过AutowireCapableBeanFactory手动调用装配，仅作参考：

@Configuration
public class MessageConfiguration {
    private final AutowireCapableBeanFactory beanFactory;

    public MessageConfiguration(AutowireCapableBeanFactory beanFactory) {
        this.beanFactory = beanFactory;
    }

    @Scope(BeanDefinition.SCOPE_PROTOTYPE)
    @Bean
    MessageConsumer getMessageConsumer() {
        KafkaMessageConsumer consumer = new KafkaMessageConsumer();
        // 手动按类型装配依赖
        beanFactory.autowireBeanProperties(consumer, AutowireCapableBeanFactory.AUTOWIRE_BY_TYPE, false);
        return consumer;
    }
}

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