Die vier Ursachen
- Die App hört auf der falschen Adresse.
localhoststatt0.0.0.0– der Klassiker. Von innen läuft alles, von außen kommt niemand an. - Der falsche Port. Die App hört auf 3000, obwohl die Umgebung
PORTvorgibt. Immerprocess.env.PORTlesen, nie fest verdrahten. - Die App ist noch nicht bereit. Braucht der Start zwanzig Sekunden, der Gesundheitscheck wartet aber nur fünf, wird sie für tot erklärt.
- Die App ist abgestürzt. Dann steht der Grund im Log – meist eine fehlende Umgebungsvariable oder eine Datenbank, die nicht erreichbar ist.
Ein 504 ist der Nachbar: Die App antwortet, aber zu langsam. Ursache sind meist Datenbankabfragen ohne Index oder Aufrufe fremder Schnittstellen ohne Zeitlimit.
In dieser Reihenfolge prüfen
- Logs ansehen. Steht dort ein Absturz, ist die Suche schon zu Ende.
- Startbefehl prüfen. Läuft überhaupt das, was laufen soll?
- Adresse und Port im Code prüfen – siehe oben.
- Von innen testen: über die Kommandozeile in den Container und dort selbst anfragen.
# im Container der App
curl -v http://127.0.0.1:$PORT/Antwortet es dort, aber nicht von außen, ist es die Adresse. Antwortet es auch dort nicht, liegt es an der Anwendung.
Vorbeugen
- Beim Start laut werden: fehlende Umgebungsvariablen sofort melden, nicht später still scheitern.
- Zeitlimits für alle ausgehenden Aufrufe setzen – sonst hängt eine Anfrage, bis der Proxy abbricht.
- Den Gesundheitscheck so großzügig einstellen, wie der Start wirklich dauert.
Häufige Fragen
Warum sehe ich 502 nur manchmal?
Dann trifft es einzelne Instanzen – etwa direkt nach einem Neustart oder wenn eine Instanz wegen Speichermangels gestoppt und neu gestartet wird.
Kann das an der Plattform liegen?
Möglich, aber selten. Die Statusseite zeigt, ob gerade eine Störung vorliegt – wenn dort alles grün ist, lohnt die Suche in der Anwendung.