Cómo hacer que tu aplicación ejecute trabajo sola, cada cierto tiempo o a una hora fija, con @Scheduled: los tres tipos de programación, la zona horaria y la trampa de tener varias copias corriendo.
También te puede interesar
Activar las tareas programadas
Muchas aplicaciones tienen trabajo que no depende de una petición: revisar pedidos atorados cada minuto, mandar un reporte a las 7 de la mañana, limpiar archivos viejos cada noche. En Spring Boot basta una anotación en la clase principal, @EnableScheduling, y otra en cada método que se debe repetir. No hace falta ninguna dependencia extra.
package com.ejemplo.tareas;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableScheduling;
@SpringBootApplication
@EnableScheduling
public class TareasApplication {
public static void main(String[] args) {
SpringApplication.run(TareasApplication.class, args);
}
}Tres formas de programar
package com.ejemplo.tareas;
import java.util.concurrent.atomic.AtomicInteger;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
@Component
public class Tareas {
private static final Logger log = LoggerFactory.getLogger(Tareas.class);
private final AtomicInteger revisiones = new AtomicInteger();
@Scheduled(fixedRate = 2000, initialDelay = 1000)
public void revisarPedidos() {
log.info("Revisión de pedidos pendientes número {}", revisiones.incrementAndGet());
}
@Scheduled(cron = "*/5 * * * * *", zone = "America/Mexico_City")
public void cada5Segundos() {
log.info("Tarea con cron: el segundo es múltiplo de 5");
}
@Scheduled(cron = "0 0 7 * * MON-FRI", zone = "America/Mexico_City")
public void reporteMatutino() {
log.info("Enviando el reporte de ventas de ayer");
}
public int revisiones() {
return revisiones.get();
}
}fixedRate = 2000: cada 2 segundos, contados desde el inicio de la ejecución anterior.initialDelayespera 1 segundo antes de la primera.fixedDelay(no se usa aquí): cada cierto tiempo, pero contado desde que terminó la anterior. Úsalo si una ejecución puede tardar más que el intervalo y no quieres que se encimen.cron: a horas fijas, con la sintaxis de cron de Spring, que tiene seis campos: segundo, minuto, hora, día del mes, mes y día de la semana.0 0 7 * * MON-FRIes «a las 7:00:00, de lunes a viernes». Pon siemprezone: si no, se usa la zona del servidor, que en la nube suele ser UTC, y tu reporte de las 7 llegaría a la 1 de la mañana.
Lo arrancamos, esperamos 8 segundos y consultamos cuántas revisiones lleva:
registro de la aplicación2026-11-22T10:31:33.858-06:00 INFO 94 --- [tareas] [ scheduling-1] com.ejemplo.tareas.Tareas : Revisión de pedidos pendientes número 1 2026-11-22T10:31:35.000-06:00 INFO 94 --- [tareas] [ scheduling-1] com.ejemplo.tareas.Tareas : Tarea con cron: el segundo es múltiplo de 5 2026-11-22T10:31:35.855-06:00 INFO 94 --- [tareas] [ scheduling-1] com.ejemplo.tareas.Tareas : Revisión de pedidos pendientes número 2 2026-11-22T10:31:37.855-06:00 INFO 94 --- [tareas] [ scheduling-1] com.ejemplo.tareas.Tareas : Revisión de pedidos pendientes número 3 2026-11-22T10:31:39.855-06:00 INFO 94 --- [tareas] [ scheduling-1] com.ejemplo.tareas.Tareas : Revisión de pedidos pendientes número 4 2026-11-22T10:31:40.000-06:00 INFO 94 --- [tareas] [ scheduling-1] com.ejemplo.tareas.Tareas : Tarea con cron: el segundo es múltiplo de 5
terminal$ curl -s localhost:8080/revisiones; echo 4
Fíjate en la hora de cada línea: las revisiones van de 2 en 2 segundos desde el arranque, y la tarea con cron cae justo en los segundos múltiplos de 5, sin importar cuándo arrancó la aplicación. El nombre del hilo, scheduling-1, dice que corren aparte de las peticiones web. El reporte matutino no aparece porque no eran las 7 de la mañana.
Con varias copias de la aplicación, cada una ejecuta la tarea. Si despliegas tres instancias detrás de un balanceador, el reporte de las 7 se manda tres veces. Las soluciones habituales son ejecutar las tareas en una sola instancia (con un perfil o una variable que las active) o usar un candado en la base de datos con una biblioteca como ShedLock. Y si una tarea lanza una excepción, Spring la registra y la vuelve a intentar en el siguiente turno; atrapa los errores dentro de la tarea para decidir tú qué hacer.
Cada proyecto de esta página se compiló con Spring Boot 4.2.0, Java 25 (Temurin 25.0.5.1) y Maven 3.10.1 en un contenedor limpio y sin red, se arrancó y se probó con las peticiones de curl que ves; las respuestas y los registros están copiados de esa ejecución.