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=alwayscon unRestartSecmolto 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
StartLimitBursteStartLimitIntervalSec. - Un aggiornamento difettoso ha cambiato un binario o una configurazione.
Verifica
- Stato e ultime righe dell'unità
systemctl status myapp --no-pager - Perché è andata in crash? Leggi il journal dell'unità
- I limiti che valgono per questa unità
systemctl show myapp -p Restart -p RestartUSec -p StartLimitBurst -p StartLimitIntervalUSec
Soluzione
- Trova prima nel journal l'errore vero e correggilo (configurazione, permessi, porta, dipendenza).
- Cancella lo stato di errore:
systemctl reset-failed myapp, poisystemctl start myapp. - Dai respiro al servizio:
RestartSec=5in[Service]e, se serve,StartLimitIntervalSec=60eStartLimitBurst=5in[Unit]. - Aggiungi
After=eRequires=per le dipendenze che devono essere pronte prima. - Dopo aver modificato il file dell'unità esegui
systemctl daemon-reload.
Scenario tipico
Hai configurato un'app Node.js come servizio systemd con Restart=always e senza RestartSec. Dopo un deploy manca il file .env, il programma esce subito con codice 1 e dopo cinque avvii in dieci secondi lo stato riporta "failed (Result: start-limit-hit)". Il servizio non riparte nemmeno dopo aver aggiunto il file. Leggi prima con journalctl -u myapp -n 50 il motivo del primo crash.
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.
Perché systemctl start non funziona ancora dopo aver risolto la causa?
Lo stato failed con il limite di avvio resta finché non lo azzeri. Esegui systemctl reset-failed myapp e poi riavvia. Senza il reset systemd continua a rifiutare nuovi avvii anche se la causa è stata eliminata.
Quali sono i valori predefiniti del limite di avvio?
Nella maggior parte delle distribuzioni sono cinque avvii in dieci secondi, controllati da StartLimitBurst e StartLimitIntervalSec. I valori globali stanno nel system.conf di systemd e si possono sovrascrivere per ogni unit. Una modifica per singola unit ha la precedenza sui valori globali di systemd.
In quale sezione dell'unit vanno le opzioni StartLimit?
Nella sezione [Unit], non in [Service]. Se le metti nella sezione sbagliata ricevi un avviso o non funzionano come previsto. Restart= e RestartSec= invece vanno in [Service]. Dopo le modifiche serve systemctl daemon-reload.