Spring Boot启用@Async与@EnableScheduling出现Bean冲突错误求助

当同时启用@EnableAsync和@EnableScheduling时，Spring会自动生成两个实现TaskExecutor接口的Bean：applicationTaskExecutor（Web环境默认任务执行器）和taskScheduler（调度任务专用执行器）。@Async默认会查找唯一的TaskExecutor Bean，因此触发NoUniqueBeanDefinitionException。

以下是三种可行的解决方法：

方法一：在@Async注解中指定执行器名称 #

直接在异步方法上指定要使用的执行器Bean名称，示例：

@Service
class MyServiceTwo {

    @Async("applicationTaskExecutor")
    void myMethod() {
        // 你的业务逻辑
    }
}

方法二：定义自定义TaskExecutor并标记为Primary #

创建自定义的线程池执行器，通过@Primary注解让Spring优先将其作为@Async的默认执行器：

@Configuration
public class AsyncConfiguration {

    @Primary
    @Bean("customAsyncExecutor")
    public TaskExecutor customAsyncExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setCorePoolSize(5);
        executor.setMaxPoolSize(10);
        executor.setQueueCapacity(20);
        executor.setThreadNamePrefix("CustomAsync-");
        executor.initialize();
        return executor;
    }
}

配置后，未指定执行器的@Async方法会自动使用这个自定义执行器，也可以通过@Async("customAsyncExecutor")显式指定。

方法三：通过@EnableAsync指定全局默认执行器 #

在启动类的@EnableAsync注解中直接配置默认使用的执行器Bean名称：

@SpringBootApplication
@EnableScheduling
@EnableAsync(defaultExecutor = "applicationTaskExecutor")
public class ApeApiApplication {

    public static void main(String[] args) {
        SpringApplication.run(ApeApiApplication.class, args);
    }
}

这种方式会让所有@Async方法默认使用指定的执行器，无需在每个方法上重复配置。

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