Spring Task 定时任务

MiniFlyZt

于 2025-04-03 16:53:03 发布

阅读量664

点赞数 27

文章标签： spring java 后端

本文链接：https://blog.youkuaiyun.com/2301_78703470/article/details/146984570

版权

定时任务是一个非常常见的需求，比如定时清理缓存、定时发送邮件、定时数据同步等。Spring Task 是 Spring 框架提供的一个轻量级定时任务工具，可以帮助我们轻松实现这些功能

一、Spring Task 简介

Spring Task 是 Spring 框架中用于定时任务调度的工具，它基于注解驱动，简单易用，适合大多数场景。Spring Task 提供了两种主要的实现方式：

基于注解的定时任务：通过 @Scheduled 注解配置定时任务的执行规则。
基于配置的定时任务：通过实现 SchedulingConfigurer 接口，自定义线程池等高级配置。

Spring Task 的核心在于其灵活性和轻量化，适合中小型项目中的定时任务需求。

二、Spring Task 入门案例

1. 添加依赖

在 Spring Boot 项目中，Spring Task 的功能已经包含在 spring-boot-starter 中，因此无需额外引入依赖。如果使用纯 Spring 框架，则需要引入 spring-context 模块。

2. 启用定时任务

在主类上添加 @EnableScheduling 注解，开启定时任务功能：

@SpringBootApplication
@EnableScheduling
public class TaskApplication {
    public static void main(String[] args) {
        SpringApplication.run(TaskApplication.class, args);
    }
}

3. 编写定时任务类

创建一个定时任务类，并使用 @Component 注解将其交给 Spring 容器管理。在方法上添加 @Scheduled 注解，配置定时规则：

@Component
public class MyTask {
    @Scheduled(cron = "0/5 * * * * ?")
    public void executeTask() {
        System.out.println("定时任务执行：" + new Date());
    }
}

三、@Scheduled 注解详解

@Scheduled 注解是 Spring Task 的核心，它支持以下几种参数：

fixedRate：任务执行的固定间隔时间（单位为毫秒），从上一次任务开始的时间点开始计算。
fixedDelay：任务执行的固定间隔时间，从上一次任务结束的时间点开始计算。
initialDelay：任务首次执行的延迟时间。
cron：使用 Cron 表达式定义复杂的定时规则，例如每天凌晨 2 点执行任务。

Cron 表达式规则

Cron 表达式是一种灵活的定时规则，格式如下：

秒分时日期月星期 [年]

例如：

0 0 2 * * ?：每天凌晨 2 点执行。

0/5 * * * * ?：每隔 5 秒执行一次。

四、线程池配置与优化

Spring Task 默认使用单线程执行任务，这可能导致多个任务阻塞。为了提高性能，可以通过以下方式配置线程池：

1. 使用 `SchedulingConfigurer` 接口

@Configuration
public class TaskSchedulerConfig implements SchedulingConfigurer {
    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        taskRegistrar.setScheduler(taskExecutor());
    }

    @Bean(destroyMethod = "shutdown")
    public Executor taskExecutor() {
        ScheduledThreadPoolExecutor executor = new ScheduledThreadPoolExecutor(5);
        executor.setThreadNamePrefix("MyScheduled-");
        return executor;
    }
}

上述代码创建了一个包含 5 个线程的线程池，并设置了线程名称前缀。

2. 配置文件方式

在 application.yml 中配置线程池：

spring:
  task:
    scheduling:
      pool:
        size: 5
        thread-name-prefix: my_task_

五、异步任务处理

为了避免阻塞主线程，可以将定时任务设置为异步执行：

@Component
public class AsyncTask {
    @Async
    @Scheduled(fixedRate = 5000)
    public void asyncTask() {
        System.out.println("异步任务执行：" + new Date());
    }
}

@Configuration
@EnableAsync
public class AsyncConfig implements AsyncConfigurer {
}

通过 @Async 注解和 @EnableAsync 启用异步任务支持。