ComfyUI kaputt? Entscheidungsbaum zur Fehlerbehebung

Wenn in ComfyUI etwas schiefläuft, ist Raten der häufigste Fehler. Dieser Entscheidungsbaum hilft dir, das Problem systematisch einzuordnen.

Entscheidung 1: Startet ComfyUI?

Prüfe, ob http://127.0.0.1:8188/system_stats Daten liefert.

• Ja -> Der Core läuft. Weiter zu Entscheidung 2.
• Nein -> Erst die Basisumgebung reparieren. Noch keine Plugins installieren.
  • prüfen: Wird Python gefunden? Ist PyTorch mit CUDA installiert? Wird wirklich run_nvidia_gpu.bat verwendet?
  • für konkrete Fehler zuerst Common Issues lesen
  • Treiber-/CUDA-Matrix in GPU Compatibility prüfen

Entscheidung 2: Der Workflow zeigt fehlende Nodes

Nach dem Import eines Workflows erscheinen manche Nodes rot oder fehlen.

Schritt 1: Ist es ein reiner Frontend-Node?

Diese brauchen keine Backend-Registrierung und sind oft unkritisch:

• Note, Reroute, MarkdownNote
• Fast Groups Muter (rgthree), Fast Groups Bypasser (rgthree)
• PrimitiveNode, GetNode, SetNode
• alles, was mit workflow> beginnt

Wenn ja -> kein echter Backend-Fehler.

Schritt 2: Ist das Plugin installiert?

• Plugin-Ordner fehlt -> richtiges Plugin installieren, siehe Install Custom Nodes
• Plugin-Ordner ist da, Node fehlt trotzdem -> weiter zu Entscheidung 3

Entscheidung 3: Plugin existiert, Node funktioniert aber nicht

Der Plugin-Ordner liegt im Dateisystem, aber die Node erscheint trotzdem nicht in ComfyUI.

Startup-Log auf IMPORT FAILED prüfen.

• Import schlägt wegen fehlendem Python-Paket fehl -> Dependency-Thema
• Import schlägt wegen Code- oder API-Fehler fehl -> Quellcode-/Kompatibilitätsproblem
• Kein Importfehler, aber Node-Name passt nicht mehr -> Node-Migration oder Umbenennung

Wenn du Requirements nachinstallierst, dann nicht blind:

1. aktives Python prüfen
2. requirements.txt lesen
3. Torch-/NumPy-/OpenCV-Pins beachten
4. wenn möglich nur das fehlende Paket gezielt installieren
5. danach pip check ausführen

Für die tiefere Analyse siehe Dependency Conflicts.

Entscheidung 4: Node ist da, wirft aber erst bei Ausführung Fehler

Der Node ist sichtbar, aber beim Queue-Start kommt ein Fehler.

• Fehler nennt Modellpfade -> meist Modellproblem, nicht Pluginproblem
• Fehler nennt Python-Modul oder Funktion -> kann weiter eine Dependency- oder Kompatibilitätsfrage sein

Wenn Modellpfade fehlen:

• Modell herunterladen
• in den korrekten Ordner legen
• siehe Download Models

Entscheidung 5: Server startet, aber UI lädt nicht

Das Terminal zeigt Starting server und To see the GUI go to: http://127.0.0.1:8188, aber der Browser bleibt hängen.

Das bedeutet nicht automatisch, dass ComfyUI nicht gestartet ist. Oft blockiert etwas nach dem eigentlichen Startup.

Häufige Kandidaten:

Direkt prüfen:

1. antwortet http://127.0.0.1:8188/system_stats?
2. lebt der python.exe-Prozess noch?

Entscheidung 6: Alles läuft, aber die Umgebung fühlt sich instabil an

ComfyUI startet, Workflows laden, aber du bekommst zufällige Crashes oder Konflikte.

Dann:

pip check

Nicht jede Warnung ist sofort kritisch:

Kurzübersicht: Fehler -> Kategorie

Verwandte Guides

• Workflow Environment Setup
• Plugin Management
• Dependency Conflicts
• Common Issues
• GPU Compatibility

Noch festgefahren?

Wenn du diesen Baum durchgegangen bist und das Problem nicht klar wird, probiere zuerst Wonderful Launcher. Wenn die Umgebung trotzdem blockiert bleibt, geh lieber früher zu Expert Help statt weiter zu raten.

Quellen

• ComfyUI troubleshooting overview
• ComfyUI custom node troubleshooting guide
• ComfyUI model troubleshooting guide
• ComfyUI Manager installation guide