Skip to Content
Low-CodeTroubleshootingHäufige Probleme

Häufige Probleme

Diese Seite beschreibt die haeufigsten Probleme beim Betrieb von LowCode und deren Loesungen.

1. Engine-Verbindung schlaegt fehl

Symptom: Engine Nodes zeigen den Status “disconnected” oder “connection refused”.

Moegliche Ursachen und Loesungen

Falsche URL:

Pruefen Sie die konfigurierte Engine-URL in der processcube-engine-config Node. In Docker-Umgebungen muss der Service-Name verwendet werden, nicht localhost.

# docker-compose.yaml
services:
  engine:
    image: marketplace.processcube.io/processcube-io/processcube_engine:latest
    ports:
      - "8000:8000"
 
  lowcode:
    image: marketplace.processcube.io/processcube-io/processcube_lowcode:latest
    environment:
      # Richtig: Service-Name verwenden
      ENGINE_URL: http://engine:8000
      # Falsch: localhost funktioniert nicht zwischen Containern
      # ENGINE_URL: http://localhost:8000

Netzwerk-Probleme:

Stellen Sie sicher, dass beide Container im gleichen Docker-Netzwerk sind:

# Netzwerk pruefen
docker network inspect <netzwerk-name>

Engine noch nicht bereit:

Die Engine benoetigt einige Sekunden zum Starten. Konfigurieren Sie depends_on mit einem Health-Check:

services:
  lowcode:
    depends_on:
      engine:
        condition: service_healthy

2. Authority-Authentication-Fehler

Symptom: Login schlaegt fehl, “Invalid redirect URI” oder CORS-Fehler im Browser.

Redirect URI stimmt nicht ueberein

Die in der Authority konfigurierte Redirect URI muss exakt mit der URL uebereinstimmen, die LowCode fuer den Callback verwendet:

Erwartet:  http://localhost:1880/auth/callback
Konfiguriert: http://localhost:1880/auth/callback/
                                                 ^-- Trailing Slash kann Probleme verursachen

Falsche Client ID oder Client Secret

Pruefen Sie die Umgebungsvariablen:

environment:
  AUTHORITY_URL: http://authority:5000
  CLIENT_ID: lowcode-client
  CLIENT_SECRET: <korrektes-secret>

CORS-Fehler

Wenn der Browser CORS-Fehler meldet, muss die Authority die LowCode-URL als erlaubten Origin konfiguriert haben:

Access-Control-Allow-Origin: http://localhost:1880

Pruefen Sie die Authority-Konfiguration fuer die erlaubten Origins des Clients.

3. Flow startet nicht nach Deploy

Symptom: Nach dem Deploy passiert nichts, oder Nodes zeigen Fehler-Status.

Node-Fehler pruefen

Oeffnen Sie die Info-Sidebar im Editor. Nodes mit Konfigurationsfehlern werden dort rot markiert. Haeufige Ursachen:

  • Fehlende Config Node: Eine Engine-Config Node ist nicht konfiguriert
  • Fehlende Abhaengigkeit: Ein installiertes Paket fehlt oder ist inkompatibel
  • Syntaxfehler in Function Nodes: JavaScript-Fehler verhindern den Start

Fehlende Node-Pakete

Pruefen Sie, ob alle benoetigten Pakete installiert sind:

# Im Container die installierten Pakete anzeigen
docker compose exec lowcode npm list --depth=0

Falls Pakete fehlen, installieren Sie diese ueber den Palette Manager im Node-RED-Editor (Menue, dann “Palette verwalten”) oder per Umgebungsvariable:

environment:
  NODE_RED_INSTALL_MODULES: "node-red-contrib-example@1.0.0"

Deploy-Modus pruefen

Stellen Sie sicher, dass der richtige Deploy-Modus ausgewaehlt ist:

  • Full: Alle Flows werden neu gestartet (empfohlen bei Problemen)
  • Modified Flows: Nur geaenderte Flows werden neu gestartet
  • Modified Nodes: Nur geaenderte Nodes werden neu gestartet

4. Dashboard nicht erreichbar

Symptom: Die URL /dashboard zeigt eine leere Seite oder einen 404-Fehler.

Dashboard-2 Paket pruefen

Das Dashboard-2-Paket muss installiert sein:

docker compose exec lowcode npm list | grep dashboard
# Erwartete Ausgabe: @flowfuse/node-red-dashboard@...

Dashboard-2 Konfiguration pruefen

  1. Oeffnen Sie den Node-RED-Editor
  2. Pruefen Sie, ob eine ui-base Node vorhanden ist
  3. Pruefen Sie, ob mindestens eine ui-page und eine ui-group konfiguriert sind
  4. Stellen Sie sicher, dass UI Nodes einer Gruppe zugeordnet sind

Pfad pruefen

Der Standard-Dashboard-Pfad ist /dashboard. Er kann in der settings.js geaendert worden sein:

// settings.js
ui: {
    path: "/dashboard"    // Standard-Pfad
}

Port-Mapping pruefen

# docker-compose.yaml
services:
  lowcode:
    ports:
      - "1880:1880"   # Host-Port:Container-Port

5. Performance-Probleme

Symptom: Langsame Ausfuehrung, hoher Speicherverbrauch, Timeouts.

Grosse Flows aufteilen

Flows mit mehr als 50 Nodes auf einem Tab sollten auf mehrere Tabs aufgeteilt werden. Der Editor wird bei sehr grossen Flows deutlich langsamer.

Blockierende Function Nodes

Synchroner Code in Function Nodes blockiert den gesamten Event-Loop:

// SCHLECHT: Blockiert den Event-Loop
while (processing) {
    // Endlosschleife bei Fehler
}
 
// GUT: Asynchron mit Timeout
const timeout = setTimeout(() => {
    node.error("Timeout erreicht", msg);
}, 30000);

Speicherlecks erkennen

Pruefen Sie den Speicherverbrauch ueber die Zeit:

# Speicherverbrauch des Containers ueberwachen
docker stats lowcode

Haeufige Ursachen fuer Speicherlecks:

  • Unbegrenzter Context: Daten im Context wachsen ohne Limit
  • Event Listener nicht bereinigt: Subscriptions werden nicht aufgeraeumt
  • Grosse Payloads im Debug: Deaktivieren Sie unbenoetigte Debug Nodes

Loesung: Context-Groesse begrenzen

// Maximale Anzahl von Eintraegen im Context begrenzen
let history = flow.get("history") || [];
history.push(newEntry);
if (history.length > 100) {
    history = history.slice(-100); // Nur die letzten 100 Eintraege behalten
}
flow.set("history", history);

Allgemeine Checkliste

Wenn keiner der oben genannten Punkte zutrifft, pruefen Sie:

  • Node-RED-Version ist aktuell
  • Docker-Image ist auf dem neuesten Stand
  • Browser-Cache wurde geleert (Strg+Shift+R)
  • Logs zeigen keine weiteren Fehler
  • Readiness-Endpunkt meldet “Ok”

Weiterführende Informationen

TroubleshootingLogs analysieren