문제 해결
ComfyUI 문제 해결 결정 트리
VerifiedLow riskTested on Windows 10, Windows 11 | Launcher 1.x | ComfyUI portable
시작 실패, 플러그인 충돌, 의존성 오류, 모델 문제를 순서대로 구분하는 가이드.
검증 환경
- OS: Windows 10 / 11
- Launcher: Wonderful Launcher v1.x
- ComfyUI: Portable / Managed install
- Python: 3.11+
- CUDA / Torch: CUDA 12.x / Torch 2.x
- 최종 확인: 2026-05-19
ComfyUI 가 고장났을 때 가장 위험한 행동은 원인을 추측한 채 바로 고치려고 드는 것입니다. 먼저 아래 순서대로 분류하세요.
1. ComfyUI 자체가 시작되는가
http://127.0.0.1:8188/system_stats 가 열리는지 확인합니다.
- 열림: 코어는 살아 있음
- 안 열림: 먼저 기초 환경부터 복구
2. 빨간 노드인가, 시작 실패인가
- 빨간 노드: 플러그인 미설치 또는 import 실패
- 시작 실패: Python / Torch / CUDA / 핵심 의존성 문제 가능성
3. 플러그인 폴더는 있는가
- 폴더가 없음: 노드 자체가 없음
- 폴더는 있는데 노드가 안 보임:
IMPORT FAILED확인
4. 에러가 모델 관련인가 Python 관련인가
- checkpoint, LoRA, ControlNet, ONNX 경로 문제: 모델 배치 문제
ModuleNotFoundError,ImportError,AttributeError: Python / 의존성 / 호환성 문제
5. Starting server 가 보이는데 UI 가 안 열리는가
이 경우 백엔드는 시작되었을 수 있습니다. 브라우저, custom node 확장, Manager 통신, proxy, VPN 을 의심합니다.
6. 전체는 뜨지만 불안정한가
pip check 로 충돌 패키지를 확인합니다.
단, 경고가 모두 즉시 수정 대상인 것은 아닙니다.
막히면 다음 문서
이 문제가 실제 ComfyUI 환경에 영향을 주고 있다면, 먼저 Wonderful Launcher 로 현재 머신을 점검하고 문서를 보며 수리 방향을 정하세요.
Wonderful Launcher 다운로드Did this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.