ComfyUI-Abhängigkeitskonflikte beheben: Keine Neuinstallation erforderlich
So beheben Sie Abhängigkeitskonflikte in ComfyUI durch Custom Nodes, Torch-Downgrades, pip-Konflikte, Plugin-Importfehler oder setuptools-Konflikte.
Testumgebung
- Betriebssystem: Windows 10 / 11
- Launcher: Wonderful Launcher v1.x
- ComfyUI: Portable-Version / Verwaltete Installation
- Python: 3.11+
- CUDA / Torch: CUDA 12.x / Torch 2.x
- Letzte Prüfung: 19. Mai 2026
Wenn Sie nach comfyui dependency conflicts, sensevoice-onnx setuptools conflict comfyui oder custom node broke environment suchen, lautet die kurze Antwort:
Installieren Sie ComfyUI nicht sofort neu. Finden Sie heraus, welches Plugin oder welche Paketänderung die Umgebung beschädigt hat, und beheben Sie den Fehler auf der kleinstmöglichen Ebene.
Wenn Ihre pip check-Ausgabe genau sensevoice-onnx requires setuptools<=65.0 lautet, nutzen Sie den SenseVoice-ONNX setuptools Konflikt-Leitfaden für eine minimale Fehlerbehebung.
Abhängigkeitskonflikte sind die unsichtbaren Killer vieler ComfyUI-Installationen. Ein Plugin installiert ein Paket, das PyTorch, NumPy, OpenCV oder andere gemeinsame Bibliotheken überschreibt, und plötzlich läuft ein am Vortag noch funktionierender Workflow nicht mehr.
Erfahren Sie hier, wie Sie diese Konflikte diagnostizieren, beheben und in Zukunft vermeiden, anstatt direkt alles neu zu installieren.
Typische Konfliktmuster rechtzeitig erkennen
Folgende Fehlermuster treten häufig auf:
| Fehlermeldung | Ursache | Beste Vorgehensweise |
|---|---|---|
qwen-tts requires transformers==... | Ein spezifischer Sprach-Workflow sperrt das Hugging Face-Paket auf eine alte Version | Ändern Sie nicht die globale Transformers-Version, außer der Workflow ist Ihnen zwingend wichtig |
mediapipe requires numpy<2 | Ein älteres MediaPipe-Plugin kollidiert mit NumPy 2.x | Vermeiden Sie ein globales Downgrade von NumPy, außer MediaPipe blockiert die Ausführung |
opencv-python-headless kollidiert mit opencv-python | Mehrere OpenCV-Varianten kämpfen um den Namensraum cv2 | Behalten Sie nur eine einzige OpenCV-Version bei |
torchscale requires timm==... | Ein altes Vision-Paket kollidiert mit einer neueren Version von timm | Prüfen Sie, welche Nodes das Paket tatsächlich benötigen |
pip install mmcv exited with code 1 | Das MMCV-Build stimmt nicht mit Python/Torch/CUDA überein | Nutzen Sie den MMCV-Leitfaden vor weiteren Paketänderungen |
Schnelldiagnose
| Symptom | Ursache | Erster Schritt |
|---|---|---|
| ComfyUI stürzt direkt nach der Installation eines Plugins ab | Das Plugin hat eine gemeinsame Abhängigkeit überschrieben | Suchen Sie im Protokoll nach IMPORT FAILED und führen Sie pip check aus |
Torch not compiled with CUDA enabled | Der PyTorch-Kernel wurde auf eine CPU-Version zurückgestuft | Reparieren Sie zuerst PyTorch, bevor Sie Plugins reparieren |
No module named 'triton' oder sageattention | Fehlende Beschleunigungskomponenten | Suchen Sie in den Spezialseiten, anstatt blind pip install auszuführen |
cv2-, ONNX- oder DLL-Importfehler | Konflikte mit Binär-Wheels | Passen Sie das Wheel an die aktuelle Python- und CUDA-Version an |
Schritt 1: Diagnose
Importfehler prüfen
Suchen Sie im Startprotokoll nach Zeilen mit IMPORT FAILED:
IMPORT FAILED: ComfyUI-ExampleNode
ModuleNotFoundError: No module named 'somepackage'pip check ausführen
Führen Sie pip check in der exakt gleichen Python-Umgebung aus, in der ComfyUI läuft:
| Installationstyp | Befehl |
|---|---|
| Windows Portable-Version | Im Portable-Hauptverzeichnis ausführen: .\python_embeded\python.exe -s -m pip check |
| Manuelle Installation (venv) | venv aktivieren und ausführen: python -m pip check |
Beispiel-Ausgabe:
some-plugin 1.0 requires numpy<2, but you have numpy 2.4.4Schritt 2: Probleme klassifizieren
A. Kritische Blockaden (Sofortige Behebung nötig)
torchwurde durch eine CPU-Version ersetzt. Nutzen Sie den Torch CUDA-Leitfaden.- Native DLLs können nicht geladen werden (z. B.
cv2).
B. Unkritische Abweichungen (Ignorieren empfohlen)
pip checkmeldet inkompatible Versionen, aber ComfyUI startet normal und alle Plugins laufen.- Goldene Regel: Reparieren Sie keine Warnungen in
pip check, solange im Betrieb alles einwandfrei funktioniert.
Schritt 3: Fehlerbehebung
Regel 1: Core-Pakete schützen
Gemeinsame Pakete wie torch, numpy, pillow und opencv-python dürfen nicht unbemerkt überschrieben werden. Testen Sie eine Installation vorab mit:
python -m pip install -r requirements.txt --dry-runRegel 2: Die richtige Python-Umgebung ansprechen
Achten Sie darauf, nicht die globale System-Python-Umgebung zu verändern.
| Installationstyp | Sicherer Befehl |
|---|---|
| Portable-Version | .\python_embeded\python.exe -s -m pip install <paket> |
| Manuelle Installation (venv) | venv aktivieren und python -m pip install <paket> ausführen |
Relevante Leitfäden
Wenn dieses Problem deine echte ComfyUI-Umgebung betrifft, starte kostenlos mit Wonderful Launcher. Reparaturfluss, Aufgabenlogs und Laufzeitprüfungen bleiben im Launcher an einem Ort; Credits sind für Bildgenerierung und messbare Tools.
Wonderful Launcher herunterladenCredit-Pakete ansehenDid this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.
ComfyUI "main.py makes it difficult to embed" Fix
Fix ComfyUI main.py makes it difficult to embed and python_embeded confusion by using the Python environment that actually starts ComfyUI.
No module named 'torch' in ComfyUI beheben
Behebe ModuleNotFoundError: No module named 'torch' in ComfyUI Portable-, venv- und verwalteten Installationen und prüfe danach, ob der reparierte Torch-Build CUDA unterstützt.