ComfyUI로 AI 워크플로우를 구축하다가 갑자기 특정 노드가 빨간색으로 변하고 클릭하면 영어 오류 메시지가 뜨는 경험이 있으셨다면 — 이 글이 바로 당신을 위한 것입니다.
1. 빨간색 오류가 발생하는 이유
ComfyUI의 노드 시스템은 Python 스크립트 기반으로 동작합니다. 특정 노드의 입력 매개변수가 요구 사항을 충족하지 않거나 의존 라이브러리가 누락되면 해당 노드가 빨간색 배경으로 표시되며 실행이 중단됩니다. 이는 주로 다음과 같은 상황에서 발생합니다.
첫 번째: 모델 가중치 파일 경로 오류 (가장 흔함)
인터넷에서 다른 사람의 워크플로우 JSON 파일을 다운로드하여 자신의 ComfyUI에 가져올 때, 상대방이 사용한 모델 파일이 로컬에 없거나 저장 경로가 다르면 Load Checkpoint 노드가 빨간색 오류를 표시합니다. 해결 방법은 오른쪽 큐 패널에서 구체적인 오류 메시지를 확인하는 것입니다. 보통 누락된 파일명을 명확히 알려줍니다. HuggingFace 또는 Civitai에서 해당 .safetensors 파일을 다운로드하여 models/checkpoints 디렉토리에 넣으면 됩니다.
두 번째: 커스텀 노드 플러그인 미설치
다른 사람의 워크플로우에서 ComfyUI-Impact-Pack이나 ComfyUI-Manager 같은 서드파티 플러그인을 사용했지만 로컬에 설치되어 있지 않은 경우입니다. 이 경우 오류 메시지에 "ModuleNotFoundError"라는 문구가 포함됩니다. 해결 단계: ComfyUI Manager를 열고(상단 툴바의 Manager 버튼 클릭) 누락된 노드 이름을 검색한 뒤 Install을 클릭하여 설치합니다.
세 번째: 입력 타입 불일치
예를 들어 특정 노드에 IMAGE 타입의 입력이 필요한데 LATENT 타입 데이터가 연결된 경우입니다. ComfyUI는 데이터 타입을 자동 변환하지 않으므로 오류가 발생합니다. 해결 방법은 두 노드 사이에 타입 변환 노드를 추가하는 것입니다. LATENT에서 IMAGE로 변환하려면 VAE Decode 노드를 사용하고, 반대의 경우 VAE Encode 노드를 사용합니다.
2. 고빈도 오류 목록 및 수정 방법
"No module named 'xxx'"
Python 의존 라이브러리가 누락된 것입니다. ComfyUI 루트 디렉토리에서 명령줄을 열고 pip install xxx를 실행하여 누락된 패키지를 설치합니다. 정확한 이름을 알 수 없는 경우 오류 메시지의 모듈 이름을 그대로 복사하여 사용하세요.
"CUDA out of memory"
비디오 메모리 부족입니다. 해결 방법: 해상도를 낮추기(예: 1024x1024에서 512x512로 변경); ComfyUI 시작 매개변수에 --lowvram 모드 추가; 또는 GPU를 사용하는 다른 프로그램을 종료합니다.
"Checkpoint file not found"
모델 파일이 누락되었거나 경로 설정이 잘못되었습니다. models/checkpoints 디렉토리에 오류 메시지에 표시된 파일명이 존재하는지 확인하세요. 대소문자가 정확히 일치해야 합니다.
"Invalid image size: must be multiple of 64"
해상도가 64의 정수 배수가 아닌 경우입니다. 너비와 높이를 800x1200이나 512x768 같은 표준 크기로 조정하면 됩니다.
3. 오류 예방을 위한 모범 사례
다른 사람의 워크플로우를 가져오기 전에 현재 프로젝트를 백업하세요(File → Save Workflow). 둘째, 새 노드 플러그인 설치 후 반드시 ComfyUI 서비스를 재시작하세요. 셋째, ComfyUI 코어 프로그램과 모든 커스텀 노드를 최신 버전으로 정기적으로 업데이트하세요. 많은 오류가 구버전 플러그인과 신버전 코어 프로그램 간의 비호환성으로 인해 발생합니다.
