ComfyUI 자주 발생하는 문제 및 해결 방법

ComfyUI 사용 중 구동 정지, 무한 재연결 루프, 이미지 생성 연산 속도 저하 등의 일반적인 에러를 마주쳤다면 본 종합 트러블슈팅 안내 페이지에서 복구 해결책을 모색해 보십시오.

만약 특정 노드 설치 이후에 서버 부팅 크래시가 멈추지 않는다면, 임의의 pip 명령어를 치기 전 아래 전용 복구 페이지들을 우선 확인하십시오.

• ComfyUI 플러그인 가져오기 실패 복구
• ComfyUI 시작 실패 진단 및 복구
• ComfyUI 의존성 충돌 해결
• ComfyUI 재연결 오류 복구

상황별 우선 복구 페이지 안내

설치 및 최초 기동 정지 문제

"CUDA is not available" 또는 "Torch not compiled with CUDA"

원인: 라이브러리 추가 조치 중 CPU 버전 PyTorch에 의해 CUDA 가속 모듈이 덮어씌워졌거나, 그래픽카드 드라이버 버전이 맞지 않습니다.

해결 방안:

1. 명령 프롬프트창을 열어 nvidia-smi를 입력하여 그래픽 드라이버의 정상 가동 상태를 점검합니다.
2. ComfyUI 구동 Python 경로를 사용하여 아래 코드가 True를 찍어 내는지 확인합니다.

python -c "import torch; print(torch.__version__); print(torch.cuda.is_available())"

3. 포터블 버전 사용 시, 본인이 NVIDIA 그래픽카드용 포터블을 다운로드했는지 재확인하고, run_nvidia_gpu.bat으로 실행해 봅니다.
4. 검사 결과가 False인 경우 Torch not compiled with CUDA enabled 복구 가이드를 따라 가상환경을 정상 복원하십시오.

윈도우 디펜더/백신 프로그램의 차단

원인: ComfyUI 구성 파일들을 악성 위협으로 오인하여 실행 bat 파일 또는 python_embeded 내부 모듈 파일들을 강제 격리했습니다.

해결 방안:

1. ComfyUI 설치 폴더 전체를 백신 프로그램의 '검사 제외 경로'로 등록하십시오.
2. Windows Defender 기준: 설정 → 업데이트 및 보안 → Windows 보안 → 바이러스 및 위협 방지 → 설정 관리 → 제외 추가 또는 제거
3. 검사 제외 등록 후, 격리된 파일이 있다면 복원 조치하고 실행합니다.

Windows 260자 경로 길이 제한 정책

원인: 윈도우 기본 파일 탐색기의 기본 최대 경로 길이 260자 제약으로 인해, 폴더 구조가 긴 일부 노드들이 시작 시 로드에 실패합니다.

해결 방안: PowerShell 창을 관리자 권한으로 켜고 아래 명령어를 쳐서 제한을 해제하십시오.

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

이후 윈도우를 다시 시작하십시오. 또한 ComfyUI 폴더 경로는 가급적 D:\ComfyUI와 같이 얕은 경로에 압축을 풀어 사용하세요.

런타임 연산 작동 문제

그래픽카드 메모리 부족 (CUDA Out of Memory)

원인: 물리 장착된 VRAM의 크기보다 출력하고자 하는 이미지 해상도나 연산 모델 용량이 큽니다.

해결 방안:

1. 인터넷 브라우저 탭, 백그라운드 게임 등 VRAM을 갉아먹는 타 무거운 앱들을 종료합니다.
2. 이미지 생성 해상도를 한 단계 줄입니다 (예: 1024에서 512로 조정).
3. 실행 배치파일 인수 끝에 --lowvram 매개변수를 한 칸 띄우고 입력해 실행시킵니다.
4. 상대적으로 가벼운 FLUX GGUF 등 양자화 모델들을 활용해 다운로드합니다.

워크플로 붉은색 노드 표시

원인: 현재 불려온 워크플로가 참조하는 커스텀 노드가 사용자 PC에 깔려 있지 않습니다.

해결 방안:

1. ComfyUI Manager 플러그인을 설치합니다.
2. 매니저 창을 연 뒤 「Install Missing Custom Nodes」(누락 노드 설치)를 눌러 자동 설치를 유도합니다.
3. ComfyUI를 완전히 종료 후 재기동합니다.

"No checkpoint found" / 모델 로더가 비어 있음

원인: 체크포인트 모델 웨이트 파일(.safetensors)이 없거나 경로를 헷갈려 잘못 배치한 경우입니다.

해결 방안:

1. 필요한 학습 모델 파일을 다운로드합니다.
2. 다운로드받은 파일을 ComfyUI/models/checkpoints/ 하위 경로에 넣어 줍니다.
3. 웹 화면 상단 모델 선택 메뉴 우측의 「Refresh」(새로고침) 단추를 누르거나 서버를 껐다 켭니다.

※ 상세 VAE, LoRA, ControlNet 등 구성 위치는 ComfyUI에서 Safetensors 파일을 둘 위치를 참고하십시오.

이미지 연산 속도가 극단적으로 느림 (CPU 모드 가동)

원인: GPU 연산 가속 런타임 바인딩이 훼손되어 파이썬 프로세스가 강제로 CPU를 이용해 렌더링하고 있습니다.

해결 방안:

1. 기동 터미널창 맨 윗부분을 훑어보아 본인의 NVIDIA 그래픽카드 이름이 활성화 장치로 찍혔는지 인지하십시오.
2. 포터블 버전 유저인 경우 꼭 run_nvidia_gpu.bat 파일로 실행 중인지 보십시오.
3. 수동 가상환경 유저인 경우 터미널을 열어 CUDA 활성 여부를 검증하세요.

python -c "import torch; print(torch.cuda.is_available())"

만약 False가 리턴된다면, CUDA 드라이버와 정합되는 버전의 PyTorch를 재설치해 주셔야 합니다.

관련 가이드

• Torch를 다시 설치하지 않고 손상된 ComfyUI 포터블 의존성 복구
• ComfyUI 플러그인 가져오기 실패 복구
• ComfyUI 의존성 충돌
• 커스텀 노드 안전하게 설치하기
• ComfyUI에서 Safetensors 파일을 둘 위치