ComfyUI Startup Failed? Schneller diagnostizieren und sauberer reparieren

Wenn ComfyUI gar nicht mehr startet, behandle das nicht wie ein generisches Installationsproblem.

Die meisten Startfehler passieren, weil sich die Umgebung nach der ursprünglichen Installation verändert hat:

• ein Plugin hat ein kritisches Paket verändert
• ein Binärpaket passt nicht mehr zur Runtime
• Torch oder CUDA sind drifted
• eine Helper-Datei oder ein Bootstrap-Schritt wurde entfernt, blockiert oder quarantined

Die eigentliche Frage ist also nicht nur:

"Wie starte ich ComfyUI?"

sondern:

"Was hat sich seit dem letzten funktionierenden Zustand verändert?"

Was "startup failed" meistens bedeutet

Startfehler sehen oft so aus:

• das App-Fenster öffnet sich und schließt direkt wieder
• ComfyUI erreicht die UI nie
• das Terminal zeigt vor dem Serverstart einen Importfehler
• ComfyUI Desktop hängt im Bootstrap
• dein Launcher meldet eine fehlende Helper-Datei

Schritt 1: Den Startfehler in eine Kategorie einordnen

Bevor du etwas reparierst, ordne den Fehler ein:

Kategorie A: Python-Importfehler beim Start

Beispiele:

ModuleNotFoundError: No module named 'sqlalchemy'
comfyui-frontend-package is not installed
ModuleNotFoundError: No module named 'cv2'
ModuleNotFoundError: No module named 'onnxruntime'

Das bedeutet meist: ein Paket fehlt oder ist kaputt. Wenn der Fehler im eigenen Startup-Pfad von ComfyUI auftaucht, behandle es eher wie eine Portable-Dependency-Reparatur als wie ein einzelnes Plugin-Problem.

Kategorie B: Core-Runtime-Drift

Beispiele:

Torch not compiled with CUDA
CUDA is not available
AttributeError: module 'torch' has no attribute '...'

Hier sind Torch, CUDA oder ein anderes kritisches Laufzeitpaket verrutscht.

Kategorie C: Plugin-Importkette blockiert den Start

Beispiele:

• ein Custom Node schlägt fehl und destabilisiert den Start
• viele Plugins brechen nach einer einzigen Installation
• die Umgebung lief vorher, bis ein Plugin oder Update kam

Hier überlappen Plugin Import Failed und Dependency Conflicts.

Kategorie D: Bootstrap- oder Launcher-Helper fehlt

Beispiele:

• eine Helper-EXE fehlt
• Antivirus hat eine Datei in Quarantäne verschoben
• ComfyUI Desktop oder ein anderer Launcher kann die Boot-Sequenz nicht abschließen

Wenn ein Bootstrapper oder eine Hilfsdatei fehlt, prüfe zuerst die Antivirus-Quarantäne, bevor du neu installierst.

Schritt 2: Den ersten echten Fehler finden, nicht das letzte sichtbare Symptom

Viele Nutzer kopieren nur die letzte Zeile. Genau das ist oft nicht die Ursache.

Suche im Startup-Log stattdessen nach:

• dem ersten IMPORT FAILED
• dem ersten ModuleNotFoundError
• dem ersten Torch-, CUDA- oder DLL-Ladefehler
• der ersten fehlenden Helper- oder Bootstrap-Datei

Alles danach kann schon nur noch Folgeschaden sein.

Schritt 3: Die kleinste passende Recovery-Aktion wählen

Wenn ein Paket fehlt

Installiere nur das fehlende Paket oder genau die Requirements, die diesen Fehler ausgelöst haben.

Starte nicht mit breiten Upgrades wie:

pip install -U everything

Das macht aus einem Startfehler schnell drei.

Wenn der erste Fehler ModuleNotFoundError: No module named 'sqlalchemy' ist, lies den SQLAlchemy-Startup-Fix. Wenn nach der Reparatur gleich der nächste Core-Import fehlt, bist du eher in einer breiteren Portable-Dependency-Reparatur gelandet.

Wenn Torch oder CUDA drifted sind

Behandle das als Core-Runtime-Problem, nicht als Plugin-Problem.

Repariere zuerst den Core-Stack, dann erst wieder Plugin-Imports prüfen.

Typische Anzeichen:

• ComfyUI fällt unerwartet auf CPU zurück
• CUDA funktionierte gestern, heute nicht mehr
• xformers, onnxruntime oder ein anderes Paket hat eine falsche Build-Variante reingezogen

Wenn eine Helper- oder Bootstrap-Datei fehlt

Prüfe:

• Antivirus-Quarantäne
• Integrität des Installationsordners
• ob die Launcher-Helper-Dateien physisch noch vorhanden sind

Für ein konkretes Beispiel siehe Bootstrapper Missing.

Schritt 4: Die Neuinstallationsfalle vermeiden

Neuinstallation fühlt sich sauber an, ist aber oft der teuerste Weg, wenn du bereits hast:

• heruntergeladene Modelle
• funktionierende Workflows
• Custom Nodes, die du weiter brauchst
• umgebungsspezifische Fixes, die du sonst neu herausfinden musst

Setze Neuinstallation nur dann als Standard, wenn:

• die Core-Runtime so beschädigt ist, dass man sie kaum noch logisch entwirren kann
• Helper-Dateien fehlen und sich nicht sauber wiederherstellen lassen
• wiederholte Paket-Reparaturen die Umgebung bereits breiter beschädigt haben

Wenn die Umgebung noch rettbar ist, versuche zuerst den funktionierenden Bestand zu erhalten.

Warum Startfehler oft nach Plugin-Arbeit auftauchen

Das Muster ist fast immer:

1. ComfyUI startet normal
2. ein Plugin wird installiert oder aktualisiert
3. eine Requirement verändert ein Core-Paket
4. der nächste Start scheitert

Darum sind Startup-Debugging und Plugin-Debugging oft dasselbe Problem auf zwei verschiedenen Ebenen.

Ein besserer Recovery-Pfad als verstreute Shell-Befehle

Der nervige Teil ist selten nur der Startfehler selbst, sondern die Reparaturschleife:

• Traceback lesen
• pip install ausprobieren
• neu starten
• neuen Fehler treffen
• weiteres Paket patchen
• irgendwann doch an Neuinstallation denken

Wonderful Launcher ist genau für diese Phase hilfreich:

• Portable- und Desktop-Umgebungen lassen sich geordneter reparieren
• du kannst eher auf Recovery statt Neuaufbau optimieren
• Modelle und Workflows bleiben besser erhalten

Wann du von Self-Recovery zu Expertenhilfe wechseln solltest

Eskaliere, wenn:

• der Startfehler nach mehreren Plugin-Reparaturversuchen immer breiter wurde
• Torch, CUDA und Plugin-Imports gleichzeitig ausfallen
• du nicht mehr sicher weißt, welche Änderung den Bruch ausgelöst hat
• die Umgebung zu einer Arbeitsmaschine oder Studio-Maschine gehört und Downtime teuer ist

Wie Wonderful Launcher hilft

Wonderful Launcher bietet einen besser geführten Recovery-Pfad, wenn:

• ComfyUI Desktop nach Plugins fragil geworden ist
• eine Portable-Umgebung über Zeit drifted
• du den Bestand erhalten willst, statt von null neu aufzubauen

Download Wonderful Launcher und nutze es, wenn du eine geordnetere Recovery willst. Wenn die Umgebung schon komplett blockiert ist, gehe lieber früher zu Expert Help, statt weiter blind Pakete zu installieren.

Verwandte Guides

• Repair Broken ComfyUI Portable Dependencies
• ModuleNotFoundError: No module named 'sqlalchemy' in ComfyUI
• ComfyUI Plugin Import Failed
• ComfyUI Dependency Conflicts
• ComfyUI Reconnecting Error
• Common Issues
• Troubleshooting Decision Tree

Quellen

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