ComfyUI 구동 실패 해결 가이드: 신속한 진단과 복구
손상된 플러그인, 의존성 패키지 충돌, 모듈 누락 및 불안정한 환경으로 인한 ComfyUI 서버 시작 실패 오류 해결법.
테스트 환경
- 운영체제: Windows 10 / 11
- 실행기: Wonderful Launcher v1.x
- ComfyUI: 포터블 버전 / 관리형 설치
- Python: 3.11+
- CUDA / Torch: CUDA 12.x / Torch 2.x
- 마지막 테스트일: 2026-05-19
서버 기동 과정에서 ComfyUI startup failed, ComfyUI won't start, 또는 ComfyUI fails before Starting server 경고와 함께 실행이 중단되는 경우, 이를 일반적인 설치 불량 문제로 여기고 섣불리 재설치를 강행하지 마십시오. 먼저 콘솔창 터미널에 남겨진 최초의 진짜 에러(첫 번째 예외 에러)를 파악한 다음 각각의 상세 복구 가이드로 이동해 해결하십시오.
대부분의 구동 실패는 초기 설정 환경에 추가 변경이 일어났을 때 발생합니다.
- 특정 커스텀 노드가 기반 필수 라이브러리를 임의 변경함
- 바이나리 패키지 규격이 현재 구동 런타임과 어긋남
- Torch 또는 CUDA 가속 버전이 충돌함
- 켜지는 데 필요한 핵심 부트스트랩 실행 파일이 보안 프로그램에 의해 차단/격리됨
즉, 근본적인 핵심 질문은 **"어떻게 해야 ComfyUI를 다시 실행할 수 있는가"**가 아니라, **"마지막 정상 상태와 현재 실행 실패 상태 사이에 구체적으로 어떤 변경이 일어났는가"**입니다.
요약 답변
터미널 콘솔창 또는 실행기 로그상에 표시된 최초의 오류 추적(Traceback) 내용을 파악하세요. 모듈 유실을 가리키는 경우 해당 유실 패키지 복구 가이드로 이동합니다. Torch나 CUDA 관련 오류라면 핵심 딥러닝 런타임의 복구를 최우선 수행합니다. 서버가 아예 켜지지도 못하고 꺼진다면 Python 라이브러리가 아닌 윈도우 백신 프로그램의 차단 여부부터 검토하십시오.
에러 발생 형태별 신속 해결 가이드
| 터미널창 표시 내용 | 추천 이동 가이드 |
|---|---|
ComfyUI startup failed 문구 외에 에러 추적 단서가 없음 | 본 페이지에 머물며 최초 에러 로그 수집 및 분석 진행 |
ModuleNotFoundError: No module named ... | ComfyUI No module named 오류 |
Torch not compiled with CUDA enabled | Torch CUDA 복구 가이드 |
서버는 켜졌으나 화면에 failed to fetch server logs가 뜸 | 서버 로그를 가져올 수 없음 |
브라우저 화면이 Reconnecting... 상태에서 멈춤 | ComfyUI 재연결 오류 |
| 최초 설치 단계에서의 설치/시작 실패 | 리소스 패키지 다운로드 실패 |
대표적인 구동 실패 유형
원격 로그 분석 결과, 발생 빈도가 가장 빈번하게 관측되는 오류 패턴은 다음과 같습니다.
| 발생 에러 내용 | 원인 | 해결 가이드 |
|---|---|---|
No module named 'triton' | 가속화 의존 라이브러리 유실/충돌 | triton 복구 |
No module named 'sageattention' | 가속 모듈 버전 불일치 | sageattention 복구 |
No module named 'llama_cpp' | LLM 보조 노드 라이브러리 부재 | llama_cpp 복구 |
No module named 'insightface' | 얼굴 보정 노드 라이브러리 부재 | insightface 복구 |
No module named 'onnx' 또는 onnxruntime | DWPose 등 ONNX 추론 기반 패키지 유실 | onnx / onnxruntime 복구 |
CUDA out of memory | 그래픽 메모리 한계 초과 | CUDA OOM 복구 |
| 배포 과정 중 리소스 다운로드 에러 | 셋업 단계의 네트워크망 불안정 | 리소스 패키지 다운로드 실패 복구 |
| 배포 과정 중 ComfyUI-Manager 에러 | 최초 기동 시 매니저 구성 에러 | ComfyUI-Manager 설치 실패 복구 |
시작 실패 오류 분류
에러 복구를 시도하기 전에 문제 현상을 아래의 범주 중 하나로 정의하세요.
범주 A: Python 모듈 로드 실패
예:
ModuleNotFoundError: No module named 'sqlalchemy'
comfyui-frontend-package is not installed
ModuleNotFoundError: No module named 'cv2'이는 단순 환경 파손에 해당합니다. 유실된 패키지가 ComfyUI 부팅 자체의 핵심 패키지인 경우 손상된 ComfyUI 포터블 의존성 복구를 따라 해결합니다.
범주 B: 기본 런타임 환경 손상
예:
Torch not compiled with CUDA
CUDA is not available
AttributeError: module 'torch' has no attribute '...'Torch 라이브러리 버전이나 CUDA 가속 드라이버 상태가 덮어써져 가속 기능 자체가 차단된 상태입니다.
범주 C: 플러그인 로드 에러에 따른 구동 차단
예:
- 특정 노드의
IMPORT FAILED가 빌미가 되어 서버 로딩이 정지함 - 신규 노드를 추가했거나 패키지를 업데이트한 뒤로 다른 다수의 노드도 동반 에러를 뿜음
이는 ComfyUI 플러그인 가져오기 실패 또는 ComfyUI 의존성 충돌 가이드를 참조해야 합니다.
범주 D: 윈도우 백신/보안 프로그램의 부팅 파일 차단
예:
- 켜질 때 필요한 bat 파일이나 exe 파일이 갑자기 감쪽같이 사라짐
- 실행을 누르면 보안 관리자 권한 알림이 연달아 뜨거나 먹통이 됨
이 경우 윈도우 디펜더 등 보안 백신의 검사 이력/검출 항목으로 이동해 격리 조치된 파일을 예외 등록 복원하십시오.
시간 절약 복구 수순
- 터미널 텍스트의 Traceback 로그를 따라가며 가장 위쪽에 발생한 최초의 진짜 에러를 파악합니다.
- 그것이 기본 런타임, 플러그인 의존성, 혹은 백신의 차단인지 분류합니다.
- 땜질식 설치 명령을 난사하지 말고 문제의 최초 에러 한 가지만 짚어서 복구합니다.
- 패키지 재조정 완료 후 다시 켜서 다음 단계의 에러가 교체되어 나오는지 봅니다.
중요 주의사항
재설치는 만능 해결책처럼 보이지만, 이미 다운로드해 둔 기가바이트 크기의 수많은 모델 파일과 워크플로, 커스텀 노드가 있는 경우 시간적으로 가장 큰 손해를 보는 길입니다.
아래 상황이 아니라면 가급적 수동 복구를 시도해 사용하던 자산들을 그대로 사용하십시오.
- 기본 런타임 환경이 심하게 뒤엉켜 원인 규명이 불가능할 때
- 부팅 실행 파일 등이 유실되어 수동 다운로드가 불가능할 때
- 땜질식 복구를 거치며 의존성 패키지들이 걷잡을 수 없이 오염되었을 때
관련 가이드
- Torch를 다시 설치하지 않고 손상된 ComfyUI 포터블 의존성 복구
- ModuleNotFoundError: ComfyUI에 'sqlalchemy' 모듈 누락
- ComfyUI 플러그인 가져오기 실패 복구
- ComfyUI 의존성 충돌
- ComfyUI 재연결 오류
- 자주 발생하는 문제
출처 참조
실제 ComfyUI 환경에서 생긴 문제라면 먼저 무료로 Wonderful Launcher 로 현재 머신을 확인하세요. 런처 안의 복구 흐름, 작업 로그, 실행 환경 점검을 한곳에서 볼 수 있습니다. 크레딧은 이미지 생성과 사용량 기반 도구용입니다.
Wonderful Launcher 다운로드크레딧 요금제 보기Did this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.