Aller au contenu

Blog

Un @Scheduled Spring s’arrête ? Soyez prévenu

· mis à jour le

Un job @Scheduled de Spring Boot qui s’arrête sans erreur attend le plus souvent derrière un autre job bloqué sur l’unique thread du planificateur ; une planification coupée, un cron à - ou une instance absente font de même. Aucun n’écrit rien, et le contrôle de santé reste UP. Voici comment confirmer chaque cause, la corriger, et être alerté le jour où cela commence.

Commençons par ce qui n’arrête pas un job. Une méthode qui échoue à chaque fois :

@Scheduled(fixedRate = 1000)
void failing() {
throw new IllegalStateException("boom");
}

Exécutée sur Spring Boot 3.5.7, elle écrit ceci chaque seconde, et continue d’être appelée :

ERROR 748 --- [ scheduling-1] o.s.s.s.TaskUtils$LoggingErrorHandler : Unexpected error occurred in scheduled task
java.lang.IllegalStateException: boom

Spring journalise l’exception d’une tâche répétée et planifie quand même l’exécution suivante. C’est utile, et c’est aussi pourquoi un job peut échouer des semaines : l’erreur est dans un journal, que personne ne lit tant que rien ne casse en aval.

Les jobs qui se taisent vraiment sont les suivants.

Pourquoi un job @Scheduled s’arrête sans erreur

Section intitulée « Pourquoi un job @Scheduled s’arrête sans erreur »

Par défaut, Spring Boot exécute toutes les méthodes @Scheduled sur un seul thread (spring.task.scheduling.pool.size vaut 1). Si l’une d’elles ne rend jamais la main, parce qu’elle attend une socket sans délai maximal, un verrou ou une file, aucune des autres ne s’exécute plus.

Je l’ai reproduit avec trois jobs : un signal chaque seconde, le job qui échoue ci-dessus, et un qui se bloque pour toujours à partir de la quatrième seconde :

17:39:40.449 heartbeat job ran
17:39:41.449 heartbeat job ran
17:39:41.451 stuck job starts and never returns
(plus rien ensuite : ni erreur, ni avertissement, le processus continue de tourner)

Le job de signal et le job qui échoue s’arrêtent tous les deux à cet instant. L’application est vivante, donc une liveness probe et un contrôle de santé sont satisfaits.

Pour le confirmer, prenez un thread dump (jstack <pid> ou l’endpoint threaddump d’Actuator ; seul health est exposé en HTTP par défaut, ajoutez donc management.endpoints.web.exposure.include: scheduledtasks,threaddump,env pour les vérifications ci-dessous) : scheduling-1 est dans la méthode bloquée, sur une lecture de socket ou un verrou.

Sans @EnableScheduling, une annotation @Scheduled n’est qu’une annotation : pas d’erreur, pas d’exécution. Elle se perd facilement dans un remaniement des classes de configuration, et l’application démarre et répond quand même. Pour le confirmer, consultez l’endpoint scheduledtasks d’Actuator : il ne liste aucune tâche.

@Scheduled(cron = "${report.cron}") accepte la valeur spéciale -, que Spring documente comme un déclencheur désactivé, prévue pour couper un job de l’extérieur. Un - laissé dans la configuration d’un environnement (copié d’un profil de test, par exemple), et ce job n’y est jamais planifié. Toute autre valeur invalide fait échouer le démarrage. Pour le confirmer, constatez l’absence de la tâche dans scheduledtasks, et cherchez report.cron dans la configuration de cet environnement. /actuator/env/report.cron montre d’où vient la propriété, mais Spring Boot 3 en masque la valeur tant que management.endpoint.env.show-values n’est pas réglé.

4. L’application ne tourne pas là où vous le croyez

Section intitulée « 4. L’application ne tourne pas là où vous le croyez »

Un job exécuté par une seule instance meurt avec elle : un déploiement réduit à zéro, une boucle de redémarrage, une instance jamais lancée dans cet environnement. Rien dans l’application ne peut le signaler, puisque l’application n’est plus là. Pour le confirmer, vérifiez le nombre de réplicas et les redémarrages (kubectl get deploy,pods).

Les quatre ont la même signature : il ne se passe rien, donc rien ne s’écrit.

Pourquoi les journaux et les contrôles de santé ne le voient pas

Section intitulée « Pourquoi les journaux et les contrôles de santé ne le voient pas »
  • Les journaux. Il n’y a pas de ligne à chercher. On peut alerter sur une erreur ; on ne peut pas alerter sur une ligne qui n’existe pas.
  • Les contrôles de santé et liveness probes. Ils disent que le processus répond, pas que ses jobs s’exécutent.
  • Les métriques. Un timer par job aide, mais repérer un job arrêté demande d’écrire une alerte sur l’absence, pour chaque job, et de garder ces règles à jour avec le code.
  • La liste des tâches planifiées. L’endpoint scheduledtasks d’Actuator montre la prochaine et la dernière exécution de chaque tâche : un job bloqué s’y voit, si quelqu’un regarde. Rien n’alerte dessus.

Comment être alerté quand un job planifié s’arrête

Section intitulée « Comment être alerté quand un job planifié s’arrête »

Le signal fiable est celui qui échoue dans le bon sens : le job signale chaque exécution réussie à un service extérieur, qui l’attend selon une planification et alerte quand elle ne vient pas. C’est un dead man’s switch. Un thread bloqué, une annotation manquante, un cron désactivé et une instance morte déclenchent la même alerte : le signal n’est pas arrivé.

Avec le starter Spring Boot de SilenceWatch, la mise en place tient en une dépendance et une clé :

pom.xml
<dependency>
<groupId>com.silencewatch</groupId>
<artifactId>silencewatch-spring-boot-starter</artifactId>
<version>0.2.0</version>
</dependency>
application.yml
silencewatch:
api-key: ${SILENCEWATCH_API_KEY}

Au démarrage, il trouve chaque méthode @Scheduled et chaque job Quartz, les déclare avec leur vraie planification, et envoie un signal autour de chaque exécution, avec sa durée et son issue : terminée normalement ou par une exception ; une exécution qui lève une exception fait passer le check en panne. Le journal le dit :

SilenceWatch discovered 2 Spring scheduled task(s)
SilenceWatch is watching 2 job(s) in environment 'production'

Le starter déclare les jobs que Spring a réellement planifiés. Un job coupé par -, ou une application qui a perdu @EnableScheduling, est détecté si son check avait déjà été déclaré : le check reste et passe en panne. Un job qui n’a jamais tourné dans un environnement, ou une instance jamais lancée là, n’a pas encore de check ; créez-le à la main.

Le début d’une exécution est signalé séparément de sa fin, et un début seul ne compte pas comme un succès. Une exécution qui commence et ne revient jamais laisse donc le check en retard, puis en panne une fois le délai de grâce écoulé, et vos canaux d’alerte sont prévenus. Une exception : quand plusieurs instances exécutent le même job sans verrou, elles partagent un check, et un planificateur bloqué sur l’une est masqué par les autres. Listez ces jobs dans silencewatch.per-instance-jobs, avec un instance-id stable, pour donner à chaque instance son propre check (plusieurs instances). Voir le démarrage rapide pour l’essayer, et les états et planifications pour les règles exactes.

Le starter est conçu pour ne pas gêner l’application : il ne fait jamais échouer ni attendre un job, et sans clé ni réseau l’application tourne comme sans lui. Le détail est sur la page Spring Boot.

Être alerté n’est que la première moitié. Pour le cas du thread bloqué, les remèdes habituels sont :

  • mettre un délai maximal sur chaque appel sortant d’un job (client HTTP, base de données, file) : un job qui peut attendre indéfiniment finira par le faire ;
  • donner plus d’un thread au planificateur, pour qu’un job lent ne retienne pas les autres : spring.task.scheduling.pool.size: 5 ;
  • sortir les longs traitements du thread du planificateur, en confiant le travail à un exécuteur et en rendant la main ; le signal marque alors la remise du travail, pas le travail, donc donnez au travail lui-même un check (un ping à la fin) ou préférez les deux remèdes ci-dessus.
Pourquoi ma méthode @Scheduled a-t-elle cessé de s’exécuter sans erreur ?

Les causes habituelles sont une autre méthode planifiée qui ne revient jamais (Spring Boot les exécute toutes sur un seul thread par défaut), la planification non activée, un cron désactivé avec la valeur "-", ou une instance de l’application qui ne tourne plus. Aucune n’écrit de ligne dans les journaux.

Que se passe-t-il quand une méthode @Scheduled lève une exception ?

Pour une tâche répétée, Spring journalise l’exception au niveau ERROR et rappelle la méthode à l’échéance suivante. Le job ne s’arrête pas, mais il peut échouer à chaque exécution sans que personne ne soit prévenu.

Combien de threads Spring utilise-t-il pour les méthodes @Scheduled ?

Un seul par défaut dans Spring Boot. Augmentez spring.task.scheduling.pool.size pour qu’un job lent ne retarde pas les autres.

Comment être alerté quand un job planifié s’arrête ?

Faites signaler chaque exécution réussie à un service qui l’attend selon une planification et alerte quand elle manque, un dead man’s switch. Le starter SilenceWatch le fait pour les jobs @Scheduled et Quartz avec une dépendance et une clé d’API.