ComfyUI 시작 실패 시 어떻게 분류하고 복구할까

ComfyUI 시작 실패는 단순 설치 실수보다, 원래 되던 환경이 나중에 깨진 경우 가 더 많습니다.

먼저 분류하기

A. Python import failure

• No module named 'sqlalchemy'
• No module named 'cv2'
• No module named 'onnxruntime'

B. 코어 runtime 드리프트

• Torch not compiled with CUDA
• CUDA is not available
• AttributeError: module 'torch' ...

C. 플러그인 연쇄 고장

• 어떤 노드 설치 후부터 시작 실패
• 다수 custom node 가 한꺼번에 실패

D. helper / bootstrap 파일 문제

• helper executable 누락
• antivirus 격리

가장 먼저 볼 것

• 첫 번째 IMPORT FAILED
• 첫 번째 ModuleNotFoundError
• 첫 번째 Torch / CUDA / DLL 에러
• 첫 번째 helper missing

마지막 줄만 보고 판단하지 마세요.

복구 원칙

• 부족한 패키지라면 그 패키지만 먼저 복구
• Torch / CUDA 가 깨졌다면 코어 runtime 부터 복구
• helper missing 이면 재설치 전에 삭제 / 격리 여부 확인
• 모델, workflow, 설정이 있다면 우선 보존

관련 문서

• ComfyUI Plugin Import Failed
• Dependency Conflicts
• Common Issues
• Troubleshooting Decision Tree