Java项目加基础定时任务的核心是使用Spring的@Scheduled注解并启用@EnableScheduling;需确保方法为public、无参、void返回,且所在类为Spring Bean;默认单线程执行,可自定义ThreadPoolTaskScheduler实现并发。

Java项目里加基础定时任务,核心是用Spring的@Scheduled注解,配合启用定时功能,不需要额外引入复杂框架。
开启定时任务支持
在启动类或配置类上加上@EnableScheduling,告诉Spring容器:这个项目要跑定时任务。
- 如果用Spring Boot,直接在主启动类加就行
- 非Boot项目,可在任意
@Configuration类上添加 - 注意:只加注解不够,方法还得是
public、无参数、返回void
写一个最简定时方法
在任意被Spring管理的Bean(比如@Service类)里,写一个普通方法,加上@Scheduled:
-
@Scheduled(fixedRate = 5000):每5秒执行一次(从上一次开始算起) -
@Scheduled(fixedDelay = 5000):上一次执行完,等5秒再执行下一次 -
@Scheduled(cron = "0 */1 * * * ?"):cron表达式,这里是每分钟执行一次
示例:
立即学习“Java免费学习笔记(深入)”;
(注意:cron表达式6或7位,常用6位;秒在最前)定时任务的执行线程
默认所有@Scheduled方法共用一个单线程池,意味着:如果某个任务执行时间长,会阻塞后续任务。
- 想并行执行多个定时任务?得自定义
TaskScheduler - 简单做法:在配置类中@Bean一个
ThreadPoolTaskScheduler,设置pool.size - 然后在
@EnableScheduling所在类里重写scheduledExecutor()方法(Spring Boot 2.6+推荐用@Bean TaskScheduler)
注意事项和常见坑
- 方法不能是
private或static,否则不生效 - 类必须是Spring Bean(不能new出来,得靠IOC注入)
- 开发时建议加日志,确认是否真的触发了
- 生产环境慎用
fixedRate——任务若超时,可能堆积甚至OOM - 需要动态控制启停?考虑用
@EventListener监听上下文事件,或结合数据库开关字段
基本上就这些。不复杂但容易忽略细节,配好就能跑起来。










