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, sichere zuerst den ersten echten Fehler, den Python-Pfad, den letzten Installationsbefehl und pip check, statt weiter zu raten.

Quellen

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