systemd: Start request repeated too quickly (start-limit-hit)

Come appare il messaggio

myapp.service: Start request repeated too quickly.
myapp.service: Failed with result 'start-limit-hit'.
Failed to start myapp.service - My application.

Cause frequenti

• Il programma termina subito dopo l'avvio: configurazione errata, file mancante, problema di permessi o una porta già in uso.
• Restart=always con un RestartSec molto breve riavvia troppo spesso un servizio rotto.
• Una dipendenza (database, mount, rete) non è ancora pronta.
• Più di 5 avvii in 10 secondi, i valori predefiniti di StartLimitBurst e StartLimitIntervalSec.
• Un aggiornamento difettoso ha cambiato un binario o una configurazione.

Verifica

1. Stato e ultime righe dell'unità
   systemctl status myapp --no-pagerCopia
2. Perché è andata in crash? Leggi il journal dell'unità
   journalctl -u myapp -n 50 --no-pagerCopia
3. I limiti che valgono per questa unità
   systemctl show myapp -p Restart -p RestartUSec -p StartLimitBurst -p StartLimitIntervalUSecCopia

Soluzione

• Trova prima nel journal l'errore vero e correggilo (configurazione, permessi, porta, dipendenza).
• Cancella lo stato di errore: systemctl reset-failed myapp, poi systemctl start myapp.
• Dai respiro al servizio: RestartSec=5 in [Service] e, se serve, StartLimitIntervalSec=60 e StartLimitBurst=5 in [Unit].
• Aggiungi After= e Requires= per le dipendenze che devono essere pronte prima.
• Dopo aver modificato il file dell'unità esegui systemctl daemon-reload.

Domande frequenti

Posso semplicemente alzare il limite di avvii?

Si può, ma nasconde solo un ciclo di crash. Prima capisci perché il processo termina. Alza il limite solo per un servizio che deve riavviarsi spesso.

Come vedo tutte le unità fallite?

Con systemctl --failed.