Tareas programadas en Spring Boot con @Scheduled y cron

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.

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. initialDelay espera 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-FRI es «a las 7:00:00, de lunes a viernes». Pon siempre zone: 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.