ComfyUI Plugin Import Failed: Custom-Node-Fehler beheben

Wenn ComfyUI startet, aber Custom Nodes nicht geladen werden, wurde das Plugin oft zwar heruntergeladen, kann aber vom Python-Prozess nicht sauber importiert werden.

Wenn du nach comfyui plugin import failed suchst, ist die Kurzantwort:

• finde zuerst das genaue Plugin und die erste Traceback-Zeile
• repariere den frühesten Importfehler, nicht den roten Node, den du erst später siehst
• installiere Pakete nur in die Python-Umgebung, die ComfyUI wirklich startet
• behandle das zuerst als Dependency- oder Packaging-Problem, nicht als Beweis dafür, dass ganz ComfyUI kaputt ist

Typischerweise steckt einer dieser vier Fälle dahinter:

• ein erforderliches Python-Paket fehlt
• ein Plugin hat eine inkompatible Abhängigkeit installiert
• Torch oder ein anderes Core-Paket wurde überschrieben oder downgraded
• das Plugin-Repo ist veraltet, umgezogen oder nur teilweise installiert

Diese drei Symptome solltest du sauber trennen:

Repariere immer die früheste kaputte Schicht. Ein Runtime-Paket zu installieren hilft nicht, wenn das Plugin seine Nodes nie registriert hat.

Wie sich der Fehler typischerweise zeigt

Du siehst oft eines oder mehrere dieser Symptome:

• IMPORT FAILED im Startup-Log
• der Plugin-Ordner existiert, aber die Nodes erscheinen nicht in ComfyUI
• ein Workflow öffnet sich nach dem Neustart mit roten Nodes
• ein Node funktionierte vorher und brach nach einer anderen Plugin-Installation
• ComfyUI Desktop oder ein Portable-Build wird nach Custom Nodes instabil

Typische Logzeilen:

IMPORT FAILED: ComfyUI-ExampleNode
ModuleNotFoundError: No module named 'somepackage'

IMPORT FAILED: ComfyUI-AnotherNode
ImportError: DLL load failed while importing cv2

IMPORT FAILED: ComfyUI-SomePlugin
AttributeError: module 'torch' has no attribute '...'

Schritt 1: Welches Plugin ist wirklich kaputt?

Starte nicht mit zufälligen pip install-Befehlen.

Beantworte zuerst:

1. Welches Plugin ist beim Import fehlgeschlagen?
2. Welcher genaue Fehlertyp hat den Import gestoppt?

Prüfe diese Stellen in Reihenfolge:

Startup-Log

Suche nach IMPORT FAILED und kopiere die vollständige Traceback. Dort steht, welches Plugin kaputt ist und welches Python-Objekt nicht importiert werden konnte.

ComfyUI Import-Failure-API

Wenn ComfyUI noch weit genug startet, öffne:

http://127.0.0.1:8188/v2/customnode/import_fail_info_bulk

Das liefert eine JSON-Liste der fehlgeschlagenen Custom-Node-Imports.

Workflow-Symptome

Wenn rote Nodes auftauchen, prüfe:

• fehlt nur eine Plugin-Familie?
• fehlen viele, eigentlich unabhängige Plugins?
• funktionierte dieses Plugin noch, bevor du ein anderes installiert hast?

Damit erkennst du schneller, ob der Schaden lokal oder global ist.

Schritt 2: Den Fehler erst klassifizieren, dann reparieren

Die meisten Importfehler fallen in eine dieser Gruppen:

Fehlendes Paket

Beispiel:

ModuleNotFoundError: No module named 'onnxruntime'

Das ist meist der einfachste Fall. Das Plugin erwartet ein Paket, das in der aktiven Umgebung fehlt.

Defektes Binärpaket

Beispiel:

ImportError: DLL load failed while importing cv2

Das Paket kann installiert sein, aber das Wheel passt nicht zu Python, CUDA oder Windows-Runtime.

Core-Dependency-Drift

Beispiel:

AttributeError: module 'torch' has no attribute '...'

Das heißt oft, dass eine andere Plugin-Installation ein Core-Paket wie torch, numpy, pillow oder opencv-python verändert hat.

Repo- oder Quellcodeproblem

Beispiele:

• das Repo ist umgezogen
• das Plugin wurde nur halb geklont
• Git LFS hat nur Pointer-Dateien hinterlassen
• das Plugin ist zu alt für deine aktuelle ComfyUI-Version

Häufige Paket-Routen

Wenn die Traceback eines dieser Pakete nennt, nutze zuerst den gezielten Guide:

Schritt 3: Die Umgebung gezielt reparieren

Wenn du die Fehlerklasse kennst, wähle die kleinste passende Reparatur.

Wenn ein Paket fehlt

Installiere das fehlende Paket in genau die Python-Umgebung, die ComfyUI startet:

Dann ComfyUI neu starten und erneut testen.

Wenn du Dependency-Drift vermutest

Führe in derselben Python-Umgebung aus:

pip check

Achte besonders auf Konflikte bei:

• torch
• torchvision
• torchaudio
• numpy
• pillow
• opencv-python
• transformers
• diffusers

Wenn ein Plugin-Install eines dieser Pakete verändert hat, repariere zuerst das Core-Paket und teste danach erst wieder das Plugin. Für den breiteren Ablauf siehe ComfyUI Dependency Conflicts.

Wenn das Plugin selbst veraltet oder kaputt ist

Prüfe im custom_nodes/-Ordner:

• ist es wirklich das richtige Repo?
• liegen dort echter Code oder nur Git-LFS-Pointer?
• unterstützt das Plugin deine ComfyUI-Version noch?
• verlangt das README zusätzliche manuelle Pakete?

Falls nötig:

cd custom_nodes/<plugin-name>
git pull

Installiere Requirements nur mit Vorsicht:

Schritt 4: Erkennen, wann die CLI-Reparaturschleife schlimmer wird

Manuelle Reparatur ist sinnvoll, aber teuer, sobald du in diese Schleife rutschst:

• ein Paket installieren
• ComfyUI neu starten
• neuer Importfehler
• weiteres Paket installieren
• Torch kaputtmachen
• irgendwann doch über Neuinstallation nachdenken

Dann ist das Problem meist nicht mehr "ein Paket fehlt", sondern "die Umgebung driftet bereits sichtbar".

Wann Wonderful Launcher sinnvoll wird

Wonderful Launcher ist vor allem dann hilfreich, wenn du nicht mehr nur einen klaren Einzelimport reparierst:

• mehrere Plugins schlagen nacheinander fehl
• du willst Workflows, Modelle und Einstellungen erhalten
• du brauchst eine sauberere Recovery-Route als immer neue Shell-Befehle
• du willst den Schaden begrenzen, statt die Umgebung weiter zu verwischen

Wenn dein Problem eher nach Startup-Crash aussieht, lies ComfyUI Startup Failed. Wenn das ganze System nach einer Node-Installation wegrutschte, gehe direkt zu Dependency Conflicts.

Verwandte Guides

• ComfyUI Startup Failed
• ComfyUI Dependency Conflicts
• Install Custom Nodes Safely
• ComfyUI Failed to Get Custom Node List

Quellen

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