springboot定时任务

封面图 • 2026-01-16 • Java

Spring Boot 中的定时任务（Scheduled Tasks）是通过 `@Scheduled` 注解来实现的，它允许你以固定的时间间隔或特定时间点执行某些方法。这在处理后台任务、数据清理、日志记录、定时更新等场景中非常有用。

---

## 一、基本用法

### 1. 启用定时任务支持

在 Spring Boot 应用中，默认是不启用定时任务的。你需要在主类或配置类上添加 `@EnableScheduling` 注解：

```java
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableScheduling;

@SpringBootApplication
@EnableScheduling // 启用定时任务
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}
```

---

### 2. 创建定时任务类

创建一个 Bean 类，并使用 `@Scheduled` 注解标记需要定时执行的方法。

```java
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;

@Component
public class MyTask {

@Scheduled(fixedRate = 5000) // 每隔 5 秒执行一次
    public void doSomething() {
        System.out.println("定时任务执行了: " + new java.util.Date());
    }

@Scheduled(cron = "0 0 * * * *") // 每小时整点执行
    public void hourlyTask() {
        System.out.println("每小时执行的任务");
    }

@Scheduled(initialDelay = 1000, fixedRate = 60000) // 初始延迟 1 秒后开始，之后每分钟执行一次
    public void minuteTask() {
        System.out.println("每分钟执行的任务");
    }
}
```

---

## 二、`@Scheduled` 的常用参数

| 参数 | 说明 |
|------|------|
| `fixedRate` | 固定频率，单位毫秒，不管任务是否完成，每隔指定时间执行一次 |
| `fixedDelay` | 固定延迟，任务完成后，再等待指定时间执行下一次 |
| `initialDelay` | 首次执行的初始延迟时间 |
| `cron` | 使用 Cron 表达式定义执行时间，如 `"0 0 * * * *"` 表示每小时整点 |

---

## 三、Cron 表达式详解

Cron 表达式由 6 或 7 个字段组成，分别表示：

```
秒 分 时 日 月 周几 [年]
```

例如：
- `"0 0 * * * *"`：每小时的第 0 分钟第 0 秒执行
- `"0 30 9 * * *"`: 每天早上 9:30 执行
- `"0 0 12 * * ?"`：每天中午 12 点执行
- `"0 0 12 * * 1"`：每周一的中午 12 点执行

> 📌 可以使用在线 Cron 表达式生成器来帮助构建表达式，例如：[https://crontab.guru/](https://crontab.guru/)

---

## 四、注意事项

- 定时任务方法不能有返回值（除非是 `void`）。
- 如果任务耗时较长，可能会导致任务堆积（特别是使用 `fixedRate` 时）。
- 定时任务默认在主线程中执行，如果任务耗时长，可能会影响应用性能。可以考虑使用异步任务。

---

## 五、异步定时任务（可选）

如果你希望定时任务在独立线程中运行，可以结合 `@Async` 注解和 `@EnableAsync` 来实现：

```java
import org.springframework.scheduling.annotation.Async;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;

@Component
public class AsyncTask {

@Async
    @Scheduled(fixedRate = 5000)
    public void asyncTask() {
        System.out.println("异步任务执行了: " + new java.util.Date());
    }
}
```

然后在主类中添加 `@EnableAsync`：

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

---

## 六、总结

| 功能 | 方法 |
|------|------|
| 启用定时任务 | `@EnableScheduling` |
| 定时任务注解 | `@Scheduled` |
| 支持的参数 | `fixedRate`, `fixedDelay`, `initialDelay`, `cron` |
| 异步支持 | `@Async` + `@EnableAsync` |

---

如果你有具体需求，比如“每天凌晨 1 点执行某个任务”或者“按固定时间间隔执行”，我可以帮你写具体的代码示例。欢迎继续提问！