Skip to main content
Wenn deine Anwendung beim Upload abgelehnt wird, beim Start abstürzt oder nie antwortet, nennt der Fehlercode oder das Konsolenlog fast immer das genaue Problem. Finde den passenden Fehler unten.

​
Fehler bei Upload und Deploy

Diese Codes liefern das Dashboard, die CLI oder die API zurück, wenn Square Cloud einen Upload ablehnt. Es wird nichts deployt: Behebe also die Ursache und lade erneut hoch.

​
INVALID_DEPENDENCY

Was es bedeutet: Der Upload enthält keine Abhängigkeitsdatei für seine Sprache, oder die Datei ist leer. Square Cloud prüft, ob diese Datei im Stammverzeichnis der ZIP-Datei liegt, bevor irgendetwas installiert wird. So behebst du es: Lege die Abhängigkeitsdatei ins Stammverzeichnis der ZIP-Datei, neben squarecloud.app, und stelle sicher, dass sie nicht leer ist: package.json (Node.js, Bun, Deno), requirements.txt oder pyproject.toml (Python), Cargo.toml (Rust), Gemfile (Ruby), go.mod oder go.work (Go) oder mix.exs (Elixir). Lade das Projekt dann erneut hoch. Ein falsch geschriebenes Paket oder eine falsche Version zeigt sich erst später, als Installationsfehler in den Logs.

​
KEEP_CALM

Was es bedeutet: Du oder eine Automatisierung hat eine Aktion zu schnell wiederholt, etwa einen Neustart, einen Upload oder einen Snapshot. So behebst du es: Warte einen Moment und versuche es erneut. Die abgelehnte Aktion wurde einfach nicht ausgeführt: KEEP_CALM stoppt oder beeinträchtigt nie eine laufende Anwendung. Schlägt ein Snapshot stattdessen mit DAILY_SNAPSHOTS_LIMIT_REACHED fehl, ist das tägliche Snapshot-Kontingent deines Plans bis zum nächsten Tag aufgebraucht.

​
Website lädt nicht

Was es bedeutet: Die Anwendung ist deployt, aber beim Aufruf ihrer Adresse erscheint statt deiner Website eine dieser Seiten:
  • “The website took too long to respond”: Square Cloud hat deine Anwendung gefunden, aber keine Antwort von ihr erhalten.
  • “This site couldn’t be found”: Unter dieser Adresse ist keine Website veröffentlicht.
So behebst du einen Timeout:
  1. Lass deinen Server auf Port 80 und Host 0.0.0.0 lauschen. Ein Server, der an localhost, 127.0.0.1 oder einen anderen Port (3000, 5173, 8080…) gebunden ist, ist nicht erreichbar. Die Runtime setzt die Umgebungsvariablen PORT und HOST auf diese Werte, lies sie also aus:
  2. Öffne die Logs: Ist die Anwendung abgestürzt oder installiert sie noch Abhängigkeiten oder baut, kann die Website noch nicht antworten. Behebe den dort angezeigten Fehler oder warte, bis der Build fertig ist.
  3. Prüfe, ob MEMORY dem Build genug Raum lässt: Ein Framework-Build, dem der RAM ausgeht, stoppt die Anwendung mit LACK_OF_RAM.
So behebst du “This site couldn’t be found”:
  1. Prüfe die Adresse: Sie lautet https://<SUBDOMAIN>.squareweb.app, mit der Subdomain aus deiner Konfigurationsdatei.
  2. Wenn du gerade deployt hast, warte bis zu einer Minute, bis die Adresse veröffentlicht ist.
  3. Eine Anwendung, die ohne SUBDOMAIN deployt wurde, ist keine Website und kann auch keine werden: Lade sie erneut als neue Anwendung hoch, mit gesetzter SUBDOMAIN.
  4. Bei einer eigenen Domain kann sich das DNS noch verbreiten. Siehe warum sich deine Domain noch nicht verbreitet hat.

​
EADDRINUSE (Port bereits belegt)

Was es bedeutet: Die App versucht, denselben Netzwerkport zweimal zu binden. Warum es passiert: Im Code werden zwei Server gestartet, oder ein listen(...)-Aufruf wird innerhalb eines Event-Handlers erneut erzeugt (zum Beispiel bei jeder Anfrage oder jedem Reconnect), statt nur einmal beim Start. So behebst du es:
  1. Starte einen Webserver, einmal, auf Port 80 und Host 0.0.0.0.
  2. Durchsuche deinen Code nach mehr als einem .listen()-Aufruf (Node.js) oder run()-Aufruf (Python/Flask/Django) und entferne den doppelten.
  3. Stelle sicher, dass der Listen-Aufruf auf oberster Ebene deiner Startdatei steht, nicht innerhalb eines Callbacks, der mehrfach ausgelöst werden kann.

​
”Cannot find module” (Node.js) und ModuleNotFoundError (Python)

Was es bedeutet: Ein Paket, das dein Code importiert, ist nicht installiert. Warum es passiert:
  • Die Bibliothek ist nicht in den dependencies der package.json (Node.js) oder in requirements.txt/pyproject.toml (Python) aufgeführt, sodass sie auf der Plattform nie installiert wird, selbst wenn sie auf deinem Rechner funktioniert.
  • In Node.js steht das Paket nur in devDependencies. Anwendungen laufen mit NODE_ENV=production, daher überspringt npm install Entwicklungsabhängigkeiten.
So behebst du es:
  1. Füge das fehlende Paket mit einer gültigen Version zu dependencies (oder zu deiner Python-Abhängigkeitsdatei) hinzu.
  2. Bestätige, dass die Abhängigkeitsdatei selbst in der hochgeladenen ZIP-Datei enthalten ist.
  3. Starte die Anwendung neu. Bei Node.js werden Abhängigkeiten nur installiert, wenn node_modules nicht existiert: Lösche node_modules (und package-lock.json, falls du eine hochgeladen hast) im Dateimanager des Dashboards und starte dann für eine saubere Neuinstallation neu.

​
better-sqlite3 / Fehler bei nativen Bindungen

Was es bedeutet: ein Fehler wie Could not locate the bindings file, wenn deine App better-sqlite3 verwendet (direkt oder über quick.db). Warum es passiert: Die installierte better-sqlite3-Version stammt aus der Zeit vor der aktuellen Node.js-LTS-Version der Plattform, sodass ihre vorgefertigte native Bindung nicht zur Runtime passt. So behebst du es:
  1. Aktualisiere better-sqlite3 auf 12.5.0 oder höher (falls du quick.db verwendest, aktualisiere es auf 9.1.7 oder höher).
  2. Lösche node_modules und package-lock.json.
  3. Starte die Anwendung für eine saubere Neuinstallation neu, die die nativen Bindungen gegen die aktuelle Runtime neu erstellt.

​
Durch ein Ressourcenlimit gestoppt

Enden die Logs mit [SQUARE-SHIELD] LACK_OF_RAM, LACK_OF_CPU oder ABUSE_REQUESTS, oder schlägt der Start der Anwendung mit CONTAINER_TEMPORARILY_SUSPENDED fehl, hat Square Cloud sie gestoppt, weil sie ihre Ressourcen überschritten hat. Die Statustabelle erklärt jeden Status und seine Behebung.

​
Uhrzeiten weichen um einige Stunden ab

Anwendungen laufen in UTC. Ein Job, der für 09:00 geplant ist, läuft um 09:00 UTC, und die Uhrzeiten, die dein Code in die Logs schreibt, sind in UTC. Rechne die Zeiten in deinem Code um oder lies im Hilfe-Center, wie du die Zeitzone deiner Anwendung änderst.

​
Weiterführende Anleitungen

Nach dem Abgleich der Logs mit den obigen Fehlern noch nicht weitergekommen? Unser Support-Team kann sich den konkreten Absturz gemeinsam mit dir ansehen.

​
Kontaktiere uns

Falls du weiterhin technische Schwierigkeiten hast, steht dir unser spezialisiertes Support-Team zur Verfügung. Kontaktiere uns und wir helfen dir gerne, jedes Problem zu lösen: die Qualität unseres Supports ist ein wichtiger Grund, warum Entwickler Square Cloud mit 4,9/5 bei 402 Bewertungen auf Google und Trustpilot bewerten.