So sieht die Meldung aus
myapp.service: Start request repeated too quickly.
myapp.service: Failed with result 'start-limit-hit'.
Failed to start myapp.service - My application.Häufige Ursachen
- Das Programm beendet sich direkt nach dem Start: falsche Konfiguration, fehlende Datei, Rechteproblem oder ein schon belegter Port.
Restart=alwaysmit sehr kurzemRestartSecstartet einen kaputten Dienst zu oft neu.- Eine Abhängigkeit (Datenbank, Mount, Netzwerk) ist noch nicht bereit.
- Mehr als 5 Starts in 10 Sekunden, die Standardwerte von
StartLimitBurstundStartLimitIntervalSec. - Ein fehlerhaftes Update hat eine Binärdatei oder Konfiguration verändert.
Prüfen
- Zustand und letzte Zeilen der Unit
systemctl status myapp --no-pager - Warum ist sie abgestürzt? Das Journal der Unit lesen
- Die für diese Unit geltenden Limits
systemctl show myapp -p Restart -p RestartUSec -p StartLimitBurst -p StartLimitIntervalUSec
Lösung
- Zuerst den echten Fehler im Journal finden und beheben (Konfiguration, Rechte, Port, Abhängigkeit).
- Den Fehlerzustand löschen:
systemctl reset-failed myapp, dannsystemctl start myapp. - Dem Dienst Luft geben:
RestartSec=5in[Service]und bei BedarfStartLimitIntervalSec=60sowieStartLimitBurst=5in[Unit]. After=undRequires=für Abhängigkeiten ergänzen, die zuerst bereit sein müssen.- Nach dem Bearbeiten der Unit-Datei
systemctl daemon-reloadausführen.
Typisches Szenario
Du hast eine Node.js-App als systemd-Dienst mit Restart=always und ohne RestartSec eingerichtet. Nach einem Deployment fehlt die .env, das Programm beendet sich sofort mit Exit-Code 1, und nach fünf Starts in zehn Sekunden steht im Status „failed (Result: start-limit-hit)“. Der Dienst startet nicht mehr, obwohl du die Datei ergänzt hast. Lies zuerst mit journalctl -u myapp -n 50 den Grund des ersten Absturzes.
Häufige Fragen
Kann ich das Startlimit einfach erhöhen?
Man kann, aber es verdeckt nur eine Absturzschleife. Zuerst klären, warum der Prozess endet. Das Limit nur für einen Dienst erhöhen, der bewusst oft neu starten soll.
Wie sehe ich alle fehlgeschlagenen Units?
Mit systemctl --failed.
Warum geht systemctl start nach der Reparatur immer noch nicht?
Der Zustand „failed“ mit Startlimit bleibt bestehen, bis du ihn zurücksetzt. Führe systemctl reset-failed myapp aus und starte danach neu. Ohne das Zurücksetzen lehnt systemd weitere Starts weiter ab, auch wenn die Ursache längst behoben ist.
Welche Standardwerte hat das Startlimit?
Bei den meisten Distributionen sind es fünf Starts innerhalb von zehn Sekunden, gesteuert über StartLimitBurst und StartLimitIntervalSec. Die globalen Vorgaben stehen in der system.conf von systemd und können je Unit überschrieben werden.
In welchen Abschnitt der Unit gehören die StartLimit-Optionen?
In den Abschnitt [Unit], nicht in [Service]. Wer sie dort einträgt, bekommt eine Warnung oder sie wirken nicht wie gedacht. Restart= und RestartSec= gehören dagegen nach [Service]. Nach Änderungen ist systemctl daemon-reload nötig.