AI IMAGE · TROUBLESHOOT

ComfyUI·스테이블 디퓨전 자주 나는 오류 30 — 원인과 해결 순서

junetapa 약 30분

ComfyUI를 쓰다 막히면 영어 오류 문장 한 줄이 남는다. 이 페이지는 자주 만나는 오류 30개를 그 원문 그대로 모아, 하나마다 원인 · 해결 순서 · 근거 링크를 붙인 찾아보기다. 2026년 10월 17일에 ComfyUI 저장소(execution.py · nodes.py · comfy/sd.py 등)와 ComfyUI-Manager 소스를 직접 받아 문장이 실제로 코드에 있는지 대조했다. 코드 밖에서 만들어지는 문장(PyTorch가 내는 CUDA 오류 등)은 공식 문서 · 공식 포럼 · GitHub 이슈에 같은 문장이 올라와 있는 것만 넣었고, 해결 순서도 그 출처에 적힌 것만 옮겼다. 브라우저 찾기(Ctrl+F)에 내 오류 문장의 앞부분을 넣으면 바로 그 항목으로 간다.

함께 보기

오류 문장을 읽는 법 자체(실행 전 검증 오류와 실행 중 예외, 콘솔 로그의 별표 · 하이픈 줄)는 ComfyUI 오류 메시지 읽는 법에, 업데이트 뒤 켜지지 않을 때 원인을 가르는 순서는 업데이트 뒤 안 켜질 때에 따로 있다. 이 페이지는 두 글을 묶는 «문장별 찾아보기»다.

이 페이지 쓰는 법 — 문장으로 찾기

오류 창이나 콘솔에 찍힌 영어 문장에서 숫자 · 파일 이름 · 경로가 없는 앞부분으로 찾는다. 파일 이름과 숫자는 사람마다 다르기 때문이다. 아래 제목 줄의 «…»와 예시 숫자가 그런 바뀌는 자리다.

오류가 생기는 때는 크게 둘이다. 실행 버튼을 누르자마자 GPU가 돌기 전에 걸리는 실행 전 검증 오류와, 생성 도중 !!! Exception during processing !!! 줄과 함께 멈추는 실행 중 예외다. 노드 · 확장 갈래의 대부분이 앞쪽이고, CUDA · VRAM과 모델 갈래의 상당수가 뒤쪽이다. 시작할 때 찍히는 경고(Warning)는 실행이 이어진다는 뜻이라 급한 순서가 다르다.

갈래개수항목 번호
설치·파이썬/의존성401 02 03 04
CUDA·VRAM605 06 07 08 09 10
모델 불러오기911 12 13 14 15 16 17 18 19
노드·확장820 21 22 23 24 25 26 27
출력·저장328 29 30
명령을 실행하기 전에

pip 재설치나 PyTorch 다시 깔기는 ComfyUI 환경 전체를 바꾼다. 공식 문서도 커스텀 노드 폴더를 옮기거나 의존성을 다시 설치하기 전에 백업부터 하라고 적었다. 명령은 반드시 ComfyUI가 쓰는 파이썬으로 실행한다. 포터블은 python_embeded 폴더의 내장 파이썬이다.

1. 설치·파이썬/의존성 오류 4개

켜지지 않거나, 켜지면서 경고가 쏟아질 때다. 대부분 «ComfyUI가 쓰는 파이썬»에 필요한 패키지가 빠졌거나 판이 맞지 않는 경우다.

01comfyui-frontend-package is not installed.

나오는 때 · 시작 직후 · 별표 줄 사이 ERROR · 그대로 종료

원인 — ComfyUI 화면(프런트엔드)은 본체 코드와 따로 pip 패키지로 나온다. 원문도 «The ComfyUI frontend is shipped in a pip package so it needs to be updated separately from the ComfyUI code»라고 적었다. 본체만 git pull로 바꾸고 패키지를 설치하지 않았거나, 업데이트 중 패키지 설치가 실패한 경우다.

해결 순서

  1. 오류 블록 안에 함께 찍힌 pip install -r requirements.txt 안내 줄을 그대로 실행한다. ComfyUI를 돌리는 그 파이썬으로 실행해야 한다.
  2. 포터블이라면 update\update_comfyui.bat를 다시 돌리고, 창에 pip 오류가 나오면 끝까지 읽는다.
  3. 공식 문서도 git으로 업데이트한 뒤에는 pip install -r requirements.txt로 프런트엔드 의존성을 올리라고 안내한다. 업데이트 뒤 문제를 가르는 순서는 업데이트 뒤 안 켜질 때에 따로 정리했다.

근거: ComfyUI app/frontend_management.py · 공식 문서 Troubleshooting Overview

02WARNING: some comfy_extras/ nodes did not import correctly.

나오는 때 · 시작 로그 · 뒤에 IMPORT FAILED: 파일 이름 줄이 이어짐 · 화면은 열림
같이 보이는 문장 · IMPORT FAILED: … · This issue might be caused by new missing dependencies added the last time you updated ComfyUI.

원인 — 본체에 함께 들어 있는 노드(comfy_extras)가 필요한 패키지를 못 찾은 것이다. 원문이 이어서 «This issue might be caused by new missing dependencies added the last time you updated ComfyUI.»라고 적는다. 지난 업데이트에서 새로 필요해진 패키지가 설치되지 않았다는 뜻이다.

해결 순서

  1. 포터블: 원문 안내대로 update/update_comfyui.bat를 실행한다.
  2. 그 밖의 설치: 원문 안내대로 ComfyUI 폴더에서 pip install -r requirements.txt를 실행한다.
  3. 다시 켜서 IMPORT FAILED 줄이 사라졌는지 본다. 커스텀 노드 쪽 실패는 26번이다.

근거: ComfyUI nodes.py

03Port 8188 is already in use on address 127.0.0.1. Please close the other application or use a different port with --port.

나오는 때 · 시작 직후 · 서버가 뜨지 않고 종료(주소 부분은 설정에 따라 다름)

원인 — ComfyUI가 쓰려는 포트를 다른 프로그램이 이미 쓰고 있다. 가장 흔한 경우는 먼저 켠 ComfyUI 창이 아직 살아 있는 것이다. 기본 포트는 8188이다.

해결 순서

  1. 이미 켜져 있는 ComfyUI 창(명령 창)을 찾아 닫고 다시 실행한다.
  2. 두 개를 함께 띄워야 하면 실행 옵션에 --port 8189처럼 다른 번호를 준다.
  3. 브라우저 주소도 바꾼 포트로 연다(http://127.0.0.1:8189).

근거: ComfyUI server.py · ComfyUI comfy/cli_args.py

04Unsupported Pytorch detected. DynamicVRAM support requires Pytorch version 2.8 or later (2.12+ is recommended). Falling back to legacy ModelPatcher.

나오는 때 · 시작 로그의 경고 · 실행은 계속됨

원인 — 설치된 PyTorch가 2.8보다 낮아 동적 VRAM 기능을 쓰지 못하고 예전 방식으로 돌아간다는 경고다. 원문은 이때 VRAM 추정이 덜 정확할 수 있다고 덧붙인다. README도 torch 2.7은 최소 지원일 뿐이고 새 판을 강하게 권한다고 적었다.

해결 순서

  1. 지금 PyTorch 판을 확인한다: python -c "import torch; print(torch.__version__)"(ComfyUI가 쓰는 파이썬으로).
  2. 올리기 전에 설치 폴더를 백업한다.
  3. NVIDIA라면 README의 설치 명령(pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130)으로 다시 설치한다.

근거: ComfyUI main.py · ComfyUI README

2. CUDA·VRAM 오류 6개

그래픽카드를 못 쓰거나 그래픽카드 메모리(VRAM)가 모자랄 때다. PyTorch가 만드는 문장이라 다른 스테이블 디퓨전 도구에서도 같은 모양으로 나올 수 있다.

05Torch not compiled with CUDA enabled

나오는 때 · 첫 실행 또는 첫 생성 때 · AssertionError

원인 — 그래픽카드를 쓰지 못하는 CPU 전용 PyTorch가 깔려 있거나, ComfyUI가 그런 파이썬으로 실행된 경우다. 커스텀 노드 설치가 torch를 다른 판으로 바꿔 버려 생기기도 한다. 인텔 GPU라면 뜻이 다르다. 공식 문서는 이때 XPU 백엔드를 못 찾은 것이니 NVIDIA용 재설치 순서를 따르지 말라고 적었다.

해결 순서

  1. NVIDIA: README 안내대로 pip uninstall torch로 지운다.
  2. README의 명령으로 다시 설치한다: pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130
  3. 공식 문서의 확인 명령 python -c "import torch; print(torch.cuda.is_available())"가 True인지 본다.
  4. 인텔 GPU: 공식 문서의 XPU 확인 명령으로 torch.xpu.is_available()부터 본다.

근거: ComfyUI README · 공식 문서 Troubleshooting Overview

06CUDA error: no kernel image is available for execution on the device

나오는 때 · 생성 버튼을 누르면 바로 · 워크플로와 상관없이

원인 — 설치된 PyTorch 빌드에 내 그래픽카드 세대용 코드가 들어 있지 않다. 공식 포럼에는 RTX 5090으로 바꾼 뒤 어떤 워크플로든 이 오류가 났다는 보고가 있다. 공식 문서는 Blackwell(RTX 50 계열)에는 CUDA 12.8 이상으로 만든 PyTorch가 필요하다고 적었고, README는 20 시리즈 이상에서 cu130 이상 PyTorch가 필요하다고 적었다.

해결 순서

  1. 그래픽카드 세대를 확인한다.
  2. 20 시리즈 이상: README의 cu130 설치 명령으로 PyTorch를 다시 깔거나, 20 시리즈 이상용 포터블을 새로 받는다.
  3. 10 시리즈 이하: README가 따로 내놓은 «pytorch cuda 12.6» 포터블을 쓴다. README는 이 판을 20 시리즈 이상에 쓰지 말라고 적었다.

근거: 공식 포럼 글(RTX 5090 CUDA 오류) · 공식 문서 Troubleshooting Overview · ComfyUI README

07cuDNN Frontend error: No valid execution plans built

나오는 때 · 첫 어텐션 층에서 멈춤 · 그림이 하나도 안 나옴

원인 — 공식 문서 설명으로는 Blackwell 세대 NVIDIA GPU에서 PyTorch 기본 어텐션(SDPA)이 cuDNN 백엔드를 골랐는데, 이 구조에 맞는 실행 계획이 없어서 난다. FLUX에서는 첫 어텐션 블록에서 바로 걸린다.

해결 순서

  1. 실행 옵션에 --use-split-cross-attention를 붙여 다시 띄운다(공식 문서 해결책 · xformers를 쓰면 이 옵션은 무시된다).
  2. PyTorch가 CUDA 12.8 이상 빌드인지 확인한다. 공식 문서는 cu121 빌드는 이 카드에서 아예 돌지 않는다고 적었다.

근거: 공식 문서 Troubleshooting Overview · ComfyUI comfy/cli_args.py

08This error means you ran out of memory on your GPU.

나오는 때 · 생성 도중 · Exception during processing 아래(원래 예외는 torch.OutOfMemoryError 등)
같이 보이는 문장 · torch.OutOfMemoryError · CUDA out of memory

원인 — 그래픽카드 메모리가 모자라다. ComfyUI가 원문에 «TIPS: If the workflow worked before you might have accidentally set the batch_size to a large number.»를 붙인다. 이때 ComfyUI는 올려 둔 모델을 모두 내린다.

해결 순서

  1. batch_size와 그림 크기부터 줄인다(공식 문서의 첫 처방).
  2. 그래픽카드를 쓰는 다른 프로그램을 닫는다.
  3. 더 가벼운 모델로 바꾸거나 메모리 옵션을 쓴다. 사양별 기준은 모델별 VRAM 정리에 있다.

근거: ComfyUI execution.py · 공식 문서 Troubleshooting Overview · ComfyUI comfy/model_management.py

09Allocation on device 0 would exceed allowed memory. (out of memory)

나오는 때 · 생성 도중 · 큰 덩어리를 한 번에 잡을 때

원인 — 한 번에 요청한 메모리가 허용치를 넘었다는 PyTorch 문장이다. GitHub 이슈 #14340에는 리눅스의 24GB급 카드(로그상 장치 한도 23.51GiB)에서 5.10GiB를 요청하다 이 문장으로 멈춘 로그가 올라와 있다. 문장에 out of memory가 들어 있어 ComfyUI는 이것도 메모리 부족으로 처리하고 8번과 같은 안내를 붙인다.

해결 순서

  1. 8번 순서(크기·배치 줄이기, 다른 프로그램 닫기)를 먼저 한다.
  2. 같은 이슈의 댓글에서 우회책으로 --disable-smart-memory가 언급됐다. 모델을 VRAM에 붙잡아 두지 않고 일반 RAM으로 적극 내리는 옵션이다(옵션 설명 원문).
  3. 그래도 나면 이슈 글에서 진행 상황과 요청하는 로그를 확인한다.

근거: GitHub 이슈 #14340 · ComfyUI comfy/cli_args.py · ComfyUI comfy/model_management.py

10Warning: Ran out of memory when regular VAE decoding, retrying with tiled VAE decoding.

나오는 때 · VAE 디코드 단계의 경고 · 실행은 계속됨

원인 — 오류가 아니다. 잠재 이미지를 그림으로 바꾸는 VAE 디코드에서 VRAM이 모자라자 ComfyUI가 스스로 «타일 디코드»로 다시 시도한다는 뜻이다. 인코드 쪽에도 같은 모양의 경고가 있다.

해결 순서

  1. 그림이 제대로 나왔다면 그대로 둬도 된다.
  2. 매번 뜨고 느리다면 그림 크기를 줄이거나, 처음부터 타일 디코드 노드(VAEDecodeTiled)를 쓴다.

근거: ComfyUI comfy/sd.py · ComfyUI nodes.py

3. 모델 불러오기 오류 9개

모델 파일을 못 찾거나, 파일이 깨졌거나, 서로 다른 계열의 모델을 한 워크플로에 섞었을 때다.

11Value not in list: ckpt_name: 'model-name.safetensors' not in []

나오는 때 · 실행 전 검증 · lora_name · vae_name 등 칸 이름만 바뀌어 나옴

원인 — 목록에서 고르는 칸의 값이 내 설치본의 목록에 없다. 빈 대괄호 []는 그 종류의 폴더에 쓸 수 있는 파일이 하나도 없다는 뜻이다. 공식 문서의 «빠진 모델» 예시가 바로 이 문장이다.

해결 순서

  1. 워크플로가 요구하는 모델을 받아 종류에 맞는 폴더에 넣는다(ckpt_name → models/checkpoints, lora_name → loras, vae_name → vae).
  2. R 키(README 단축키 «Refresh graph»)를 누르거나 페이지를 새로 고친다.
  3. 노드의 칸을 눌러 내 목록에 있는 파일로 다시 고른다. 하위 폴더·이름 차이로 걸리는 경우는 오류 메시지 읽는 법에 세 갈래로 나눠 두었다.

근거: 공식 문서 Model Issues · ComfyUI execution.py · ComfyUI README

12Error while deserializing header: HeaderTooLarge

나오는 때 · 모델을 불러올 때 · 뒤에 File path와 안내 문장이 붙음

원인 — .safetensors라는 이름이지만 내용이 safetensors 형식이 아니거나 깨진 파일이다. ComfyUI는 이 경우 «The safetensors file is corrupt or invalid. Make sure this is actually a safetensors file and not a ckpt or pt or other filetype.»을 덧붙인다.

해결 순서

  1. 받은 곳에 적힌 파일 크기와 내 파일 크기를 비교한다.
  2. 다시 받는다(공식 문서 첫 처방). 디스크 여유 공간과 읽기 권한도 확인한다.
  3. 다른 모델로 시험해 그 파일만의 문제인지 가른다.

근거: ComfyUI comfy/utils.py · 공식 문서 Model Issues

13MetadataIncompleteBuffer

나오는 때 · 모델을 불러올 때 · Error while deserializing header 뒤에 붙음
같이 보이는 문장 · Error while deserializing header: incomplete metadata, file not fully covered

원인 — 받다 끊기거나 복사가 덜 된 파일이다. ComfyUI 원문 안내는 «The safetensors file is corrupt/incomplete. Check the file size and make sure you have copied/downloaded it correctly.»이다.

해결 순서

  1. 파일 크기를 받은 곳 표기와 대조한다.
  2. 이어받기 말고 처음부터 다시 받는다.
  3. 다른 드라이브·PC에서 복사해 왔다면 복사를 다시 한다.

근거: ComfyUI comfy/utils.py · 공식 포럼 글(incomplete metadata)

14ERROR: Could not detect model type of: …

나오는 때 · 체크포인트·확산 모델 로더에서

원인 — 파일은 읽혔지만 ComfyUI가 아는 어떤 모델 구조와도 맞지 않는다. LoRA 같은 다른 종류의 파일을 체크포인트 로더로 부른 경우가 흔하다. 파일 이름에 lora가 들어 있으면 원문이 «HINT: This seems to be a Lora file and Lora files should be put in the lora folder and loaded with a lora loader node..»를 덧붙인다.

해결 순서

  1. 받은 곳에서 파일 종류(체크포인트·LoRA·VAE·텍스트 인코더·확산 모델)를 확인한다.
  2. 종류에 맞는 폴더(loras · vae · text_encoders · diffusion_models)로 옮기고, 그 종류의 로더 노드로 부른다. LoRA 연결은 ComfyUI LoRA 적용하기에 있다.

근거: ComfyUI comfy/sd.py · ComfyUI folder_paths.py

15ERROR: clip input is invalid: None

나오는 때 · CLIP Text Encode 노드에서

원인 — 프롬프트를 읽는 노드에 들어온 clip이 비어 있다. 원문 설명은 «If the clip is from a checkpoint loader node your checkpoint does not contain a valid clip or text encoder model.»이다. 텍스트 인코더가 들어 있지 않은 파일을 체크포인트 로더로 불렀을 때 생긴다.

해결 순서

  1. 모델 배포처가 안내하는 텍스트 인코더를 따로 받아 models/text_encoders(또는 clip)에 넣는다.
  2. Load CLIP(또는 Load CLIP (Dual)) 노드로 불러 CLIP Text Encode에 연결한다.
  3. 배포처의 예제 워크플로 구성을 따른다.

근거: ComfyUI nodes.py · ComfyUI folder_paths.py

16ERROR: clip vision file is invalid and does not contain a valid vision model.

나오는 때 · Load CLIP Vision 노드에서

원인 — Load CLIP Vision에 고른 파일이 CLIP Vision 모델이 아니거나 깨졌다.

해결 순서

  1. models/clip_vision 폴더에 든 파일이 맞는 종류인지 확인한다.
  2. 그 워크플로(예: 이미지 프롬프트용 노드)가 요구하는 CLIP Vision 파일을 받은 곳에서 다시 받는다.

근거: ComfyUI nodes.py · ComfyUI folder_paths.py

17lora key not loaded: …

나오는 때 · LoRA를 적용할 때의 경고 · 줄이 여러 개 이어짐

원인 — LoRA 파일 안의 키가 지금 모델 구조와 맞지 않아 그 부분이 적용되지 않았다는 경고다. 실행은 이어지지만 LoRA가 일부 또는 전혀 먹지 않는다. 다른 계열(예: SDXL용 LoRA를 SD1.5 체크포인트에) 조합에서 흔하다.

해결 순서

  1. LoRA를 받은 곳에서 기반 모델(Base Model)을 확인한다.
  2. 같은 계열의 체크포인트와 함께 쓴다. 강도·연결 순서는 ComfyUI LoRA 적용하기 참고.

근거: ComfyUI comfy/lora.py

18mat1 and mat2 shapes cannot be multiplied (154x2048 and 768x320)

나오는 때 · 생성 도중 · 괄호 안 숫자는 모델마다 다름

원인 — 공식 문서는 이 문장을 «서로 다른 구조 계열의 모델을 함께 쓴 것»으로 설명한다. 샘플러 노드에서 나면 ComfyUI가 «Load CLIP» 계열 노드에 맞는 파일과 type을 골랐는지 확인하라는 TIPS를 붙인다.

해결 순서

  1. 체크포인트 · VAE · 텍스트 인코더 · ControlNet을 같은 계열(SD1.5 · SDXL · Flux 등)로 맞춘다.
  2. Load CLIP 노드를 쓰면 파일과 type 칸을 모델에 맞게 고른다.

근거: 공식 문서 Model Issues · ComfyUI execution.py

19expected input[1, 16, 128, 128] to have 4 channels, but got 16 channels instead

나오는 때 · 주로 VAE 디코드 단계 · 같은 뿌리의 문장 여럿
같이 보이는 문장 · The size of tensor a (49) must match the size of tensor b (16) at non-singleton dimension 1 · Tensors must have same number of dimensions: got 2 and 3

원인 — 역시 모델 구조 불일치다. 공식 문서는 Flux가 16채널 잠재 공간, SD1.5가 4채널을 쓴다고 설명하고, 이 문장들을 같은 원인으로 묶는다. 예를 들어 16채널인 Flux 잠재 이미지를 4채널 계열 VAE로 디코드하는 조합이 여기에 해당한다.

해결 순서

  1. VAE를 체크포인트 계열에 맞춘다.
  2. 워크플로의 모든 모델 부품이 한 계열인지 다시 본다(공식 문서 «Verify model family compatibility»).

근거: 공식 문서 Model Issues

4. 노드·확장 오류 8개

워크플로의 값·연결이 틀렸거나, 워크플로가 요구하는 커스텀 노드가 내 설치본에 없을 때다.

20Prompt outputs failed validation

나오는 때 · 실행 버튼을 누르자마자 · GPU는 돌지 않음

원인 — 워크플로의 모든 출력 노드가 실행 전 검증에 걸렸다는 겉봉투 문장이다. 진짜 원인은 그 아래 노드별 줄에 있다.

해결 순서

  1. 콘솔의 Failed to validate prompt for output N: 아래 별표 줄(원인 노드 종류·번호)과 하이픈 줄(무엇이 틀렸나)을 읽는다.
  2. 하이픈 줄의 문장을 이 목록에서 찾는다.
  3. 하나를 고치면 다음 오류가 이어 나오는 것이 정상이다. 읽는 법 전체는 오류 메시지 읽는 법에 있다.

근거: ComfyUI execution.py

21Required input is missing

나오는 때 · 실행 전 검증 · 뒤에 입력 이름이 붙음

원인 — 꼭 연결해야 하는 입력 칸이 비어 있다.

해결 순서

  1. 오류 줄에 적힌 입력 이름을 확인한다.
  2. 그 입력 점을 알맞은 노드의 출력과 선으로 잇는다.

근거: ComfyUI execution.py

22Return type mismatch between linked nodes

나오는 때 · 실행 전 검증 · received_type과 input_type이 함께 찍힘

원인 — 선으로 이은 데이터의 종류가 그 칸이 받는 종류와 다르다.

해결 순서

  1. 오류에 함께 찍힌 두 종류 이름(받은 것·받아야 할 것)을 본다.
  2. 받아야 할 종류를 내는 출력으로 선을 다시 잇는다.

근거: ComfyUI execution.py

23Value 0 smaller than min of 1

나오는 때 · 실행 전 검증 · 숫자 칸 값이 범위 밖일 때(숫자는 상황마다 다름)
같이 보이는 문장 · Value … bigger than max of … · Failed to convert an input value to a INT value

원인 — 숫자 칸의 값이 노드가 정한 최솟값·최댓값을 벗어났거나, 숫자로 바꿀 수 없는 값이 들어왔다. 오류 줄에 받은 값과 한계가 함께 찍힌다.

해결 순서

  1. 오류 줄의 칸 이름과 한계를 본다.
  2. 그 칸 하나만 범위 안의 숫자로 고친다. 다른 노드 출력이 연결돼 있으면 그 출력의 종류도 본다.

근거: ComfyUI execution.py

24Node '…' not found. The custom node may not be installed.

나오는 때 · 실행 전 검증 · 다른 검증보다 먼저 걸림
같이 보이는 문장 · Node '…' has no class_type. The workflow may be corrupted or a custom node is missing.

원인 — 워크플로가 쓰는 노드 종류가 내 설치본에 등록되어 있지 않다. 남의 워크플로가 요구하는 커스텀 노드가 없을 때다. 노드 종류 정보 자체가 없으면 «has no class_type. The workflow may be corrupted or a custom node is missing.»으로 나온다.

해결 순서

  1. ComfyUI-Manager의 «Install Missing Custom Nodes»로 빠진 노드 팩을 찾아 설치한다.
  2. ComfyUI를 완전히 다시 켠다.
  3. 그 뒤에 나오는 다음 오류(예: 11번)를 처리한다.

근거: ComfyUI execution.py · ComfyUI-Manager README

25When loading the graph, the following node types were not found

나오는 때 · 워크플로를 열 때 화면에 뜨는 창 · 노드가 빨갛게 표시됨

원인 — 화면이 워크플로를 그리다 등록되지 않은 노드 종류를 만났다. 24번과 같은 뿌리다.

해결 순서

  1. 창에 적힌 노드 이름을 Manager «Install Missing Custom Nodes»에서 찾아 설치한다.
  2. ComfyUI를 다시 켠다.
  3. 그래도 빨갛다면 시작 로그에서 그 노드 팩에 (IMPORT FAILED)가 붙었는지 본다(→ 26번). 빨간 노드 다루는 순서는 ComfyUI 입문 실전 가이드에도 있다.

근거: 공식 포럼 글(빠진 노드 종류) · ComfyUI-Manager README

26(IMPORT FAILED) · Cannot import … module for custom nodes: No module named '…'

나오는 때 · 시작 로그 «Import times for custom nodes» 목록 · 화면은 열림

원인 — 커스텀 노드를 불러오다 실패했다. 대개 그 노드가 쓰는 파이썬 패키지가 ComfyUI의 파이썬에 없다(폴더만 복사했거나, 다른 파이썬에 설치한 경우). 공식 문서는 노드마다 torch 같은 패키지 판을 엄격하게 못 박아 서로 부딪히는 경우도 원인으로 든다.

해결 순서

  1. 로그 위쪽의 No module named 줄에서 빠진 패키지 이름을 찾는다.
  2. 그 노드의 requirements.txt를 ComfyUI가 쓰는 파이썬으로 설치한다. 포터블은 .\python_embeded\python.exe -s -m pip install -r ComfyUI\custom_nodes\노드폴더\requirements.txt처럼 내장 파이썬을 쓴다.
  3. 범인이 여럿 의심되면 --disable-all-custom-nodes로 띄운 뒤 반씩 켜서 좁힌다(공식 문서 순서).

근거: ComfyUI nodes.py · 공식 문서 Custom Node Issues · ComfyUI comfy/cli_args.py

27ERROR: This installation is not allowed in this security_level. Please contact the administrator.

나오는 때 · ComfyUI-Manager에서 설치를 누를 때
같이 보이는 문장 · ERROR: This action requires BOTH: (1) 'allow_git_url_install = true' in config.ini …

원인 — ComfyUI-Manager의 보안 설정이 그 설치를 막았다. 깃 주소로 직접 설치(Install via Git URL)나 pip 설치는 별도 설정이 필요하다. 원문은 «This action requires BOTH: (1) 'allow_git_url_install = true' in config.ini ([default] section), AND (2) ComfyUI launched with a loopback --listen (127.0.0.1 or ::1)»처럼 두 조건을 함께 요구한다.

해결 순서

  1. 설치하려는 저장소를 믿을 수 있는지 먼저 확인한다.
  2. ComfyUI를 끄고, 시작 로그에 찍히는 Manager의 config.ini 경로를 열어 security_level 또는 allow_git_url_install · allow_pip_install을 README 설명대로 고친다.
  3. 다시 켠다. 원문은 security_level을 시작할 때 한 번만 읽는다고 적었다. 원격 접속(--listen 0.0.0.0)으로 띄운 상태라면 깃 주소 설치는 막힌다.

근거: ComfyUI-Manager manager_server.py · ComfyUI-Manager README

5. 출력·저장 오류 3개

결과를 내보낼 노드가 없거나, 입력 그림 파일이 없거나, 저장 위치가 허용 범위를 벗어날 때다.

28Prompt has no outputs

나오는 때 · 실행 버튼을 누르자마자

원인 — 결과를 내보내는 출력 노드(Save Image · Preview Image 등)가 워크플로에 하나도 없다. ComfyUI는 출력 노드에서 거슬러 올라가며 실행할 노드를 정하기 때문에, 출력 노드가 없으면 할 일이 없다.

해결 순서

  1. Save Image나 Preview Image 노드를 추가한다.
  2. VAE Decode 같은 마지막 노드의 출력을 그 노드에 연결하고 다시 실행한다.

근거: ComfyUI execution.py

29Custom validation failed for node: image - Invalid image file: …

나오는 때 · 실행 전 검증 · Load Image 노드에서

원인 — Load Image 칸에 적힌 파일이 내 input 폴더에 없다. 남의 워크플로에는 입력 그림의 파일 이름만 따라오고 그림 자체는 오지 않는다.

해결 순서

  1. Load Image 노드에서 내 그림을 업로드한다.
  2. 칸에서 그 파일을 다시 고르고 실행한다.

근거: ComfyUI nodes.py · ComfyUI execution.py

30**** ERROR: Saving image outside the output folder is not allowed.

나오는 때 · Save Image 노드 · 뒤에 full_output_folder와 output_dir이 찍힘

원인 — 저장할 위치가 output 폴더 밖으로 나갔다. Save Image의 filename_prefix에 들어간 폴더 부분(..나 다른 드라이브 경로 등)이 output 폴더 바깥을 가리키면 ComfyUI가 저장을 거부한다.

해결 순서

  1. filename_prefix를 output 안의 상대 경로로 고친다(예: ComfyUI 또는 내폴더/이름).
  2. 결과를 아예 다른 드라이브에 모으려면 prefix가 아니라 실행 옵션 --output-directory 경로로 output 폴더 자체를 옮긴다.

근거: ComfyUI folder_paths.py · ComfyUI comfy/cli_args.py

자주 묻는 것

내 오류 문장이 이 목록에 없으면 어떻게 하나요?

먼저 검증 오류인지 실행 중 예외인지 가릅니다. 실행 버튼을 누르자마자 GPU가 돌기 전에 나면 검증 오류이고, 생성 도중 Exception during processing과 함께 나면 실행 중 예외입니다. 콘솔 로그에서 원인 노드 이름과 마지막 오류 줄을 찾고, --disable-all-custom-nodes로 커스텀 노드를 모두 끈 채 같은 문제가 나는지 보면 본체 문제인지 커스텀 노드 문제인지 갈립니다.

Forge나 AUTOMATIC1111에서도 같은 해결이 통하나요?

CUDA·메모리·모델 파일 쪽 문장(Torch not compiled with CUDA enabled, out of memory, HeaderTooLarge 등)은 PyTorch와 safetensors가 만드는 문장이라 다른 스테이블 디퓨전 도구에서도 같은 모양으로 나올 수 있습니다. 다만 이 페이지의 해결 순서는 ComfyUI 기준이라 폴더 이름, 실행 옵션, 업데이트 방법은 쓰는 도구의 문서에서 다시 확인해야 합니다.

pip install을 했는데 그대로예요.

ComfyUI가 쓰는 파이썬과 다른 파이썬에 설치했을 가능성이 큽니다. 포터블은 python_embeded 폴더의 내장 파이썬을 쓰므로 .\python_embeded\python.exe -s -m pip install … 처럼 그 파이썬을 직접 지정해야 합니다. 설치 뒤에는 ComfyUI를 완전히 껐다가 다시 켭니다.

Warning으로 시작하는 줄도 고쳐야 하나요?

경고는 실행이 이어진다는 뜻이라 급하지 않은 경우가 많습니다. 타일 VAE 디코드로 다시 시도한다는 경고나 Unsupported Pytorch 경고는 결과가 나오면 미뤄도 됩니다. 다만 lora key not loaded는 LoRA가 실제로 적용되지 않았다는 뜻이라, 결과가 기대와 다르면 LoRA와 체크포인트의 계열부터 맞춥니다.

참고 자료

각 항목 끝의 «근거» 링크를 한곳에 모았다. 괄호 안 숫자는 이 페이지의 오류 번호다. 소스 코드는 2026년 10월 17일에 받은 판을 기준으로 했다.

  1. ComfyUI execution.py — 실행 전 검증 오류 문장(type·message 원문), 실행 중 예외의 메모리 부족·mat1 안내 문구 (08·11·18·20·21·22·23·24·28·29번). github.com
  2. ComfyUI nodes.py — Load Image 검증 문구, CLIP·CLIP Vision 로더 오류 문구, 커스텀 노드·comfy_extras 불러오기 실패 로그와 업데이트 안내, 노드 표시 이름 (02·10·15·16·26·29번). github.com
  3. ComfyUI comfy/sd.py — Could not detect model type 오류와 LoRA 파일 HINT, 타일 VAE 디코드로 다시 시도하는 경고 (10·14번). github.com
  4. ComfyUI comfy/utils.py — safetensors HeaderTooLarge · MetadataIncompleteBuffer를 만났을 때 덧붙이는 안내 문장 (12·13번). github.com
  5. ComfyUI comfy/lora.py — lora key not loaded 경고가 찍히는 조건 (17번). github.com
  6. ComfyUI comfy/cli_args.py — --port · --use-split-cross-attention · --disable-smart-memory · --disable-all-custom-nodes · --output-directory 옵션 설명 (03·07·09·26·30번). github.com
  7. ComfyUI comfy/model_management.py — 메모리 부족 예외로 판정하는 조건(is_oom) (08·09번). github.com
  8. ComfyUI server.py — 포트가 이미 쓰일 때의 오류 문장 (03번). github.com
  9. ComfyUI main.py — PyTorch 2.8 미만일 때 동적 VRAM 경고 문장 (04번). github.com
  10. ComfyUI folder_paths.py — 모델 종류별 폴더 이름, output 폴더 밖 저장을 막는 검사와 오류 문장 (14·15·16·30번). github.com
  11. ComfyUI app/frontend_management.py — comfyui-frontend-package가 없을 때의 오류와 «따로 업데이트해야 한다»는 안내 (01번). github.com
  12. ComfyUI README — NVIDIA PyTorch 설치 명령(cu130), Torch not compiled with CUDA enabled 처리, 그래픽카드 세대별 포터블, 단축키 R (04·05·06·11번). github.com
  13. ComfyUI-Manager manager_server.py — 보안 등급·깃 주소 설치·pip 설치를 막을 때의 오류 문장 (27번). github.com
  14. ComfyUI-Manager README — config.ini 위치와 security_level · allow_git_url_install 설명, Install Missing Custom Nodes (24·25·27번). github.com
  15. 공식 문서 Troubleshooting Overview — NVIDIA·인텔 GPU의 Torch not compiled 처리, Blackwell cuDNN 오류와 해결 옵션, 메모리 부족 첫 처방, 프런트엔드 패키지 갱신 (01·05·06·07·08번). docs.comfy.org
  16. 공식 문서 Model Issues — Value not in list 예시, 모델 구조 불일치 문장 묶음과 계열 설명, Error while deserializing header 해결 순서 (11·12·18·19번). docs.comfy.org
  17. 공식 문서 Custom Node Issues — 커스텀 노드 모두 끄기와 반씩 나눠 찾기, 의존성 충돌 원인 (26번). docs.comfy.org
  18. 공식 포럼 글(빠진 노드 종류) — 워크플로를 열 때 «following node types were not found» 보고 (25번). forum.comfy.org
  19. 공식 포럼 글(RTX 5090 CUDA 오류) — RTX 5090에서 no kernel image is available 보고 (06번). forum.comfy.org
  20. 공식 포럼 글(incomplete metadata) — incomplete metadata, file not fully covered 보고 (13번). forum.comfy.org
  21. GitHub 이슈 #14340 — Allocation on device 0 would exceed allowed memory 로그와 --disable-smart-memory 우회 언급 (09번). github.com
이 페이지의 오류 문장과 해결 순서는 2026년 10월 17일에 받은 ComfyUI 저장소(master)와 ComfyUI-Manager(main)의 소스 · README, ComfyUI 공식 문제 해결 문서 세 쪽(Troubleshooting Overview · Model Issues · Custom Node Issues), 공식 포럼 글 세 개, GitHub 이슈 한 개를 대조해 옮겼다. 문장 속 숫자 · 파일 이름 · 주소는 예시이며 쓰는 환경마다 다르다. ComfyUI는 자주 갱신되므로 문장과 옵션은 쓰는 판에서 다시 확인한다. pip 명령과 PyTorch 재설치는 설치 폴더를 백업한 뒤에 한다. 이 글은 ComfyUI 개발진과 관계없는 개인 블로그의 정리다.
ComfyUI오류해결스테이블디퓨전AI이미지CUDA커스텀노드
junetapa(박준철)
AI 도구를 직접 굴려 보고 남은 기록을 정리한다.
Twitter Facebook URL 복사
Related

관련 포스트

ComfyUI 오류 Prompt outputs failed validation 뜻
AI 도구
ComfyUI 오류 Prompt outputs failed validation 뜻
 ComfyUI 업데이트 뒤 안 켜질 때 — 되돌리기와 커스텀 노드 가르기
AI 도구
ComfyUI 업데이트 뒤 안 켜질 때 — 되돌리기와 커스텀 노드 가르기
 내 그래픽카드로 스테이블 디퓨전이 될까 — VRAM 8·12·16·24GB 모델별 사양
AI 도구
내 그래픽카드로 스테이블 디퓨전이 될까 — VRAM 8·12·16·24GB 모델별 사양
 ComfyUI 입문 실전 가이드 — 컴퓨터 사양부터 첫 이미지까지
AI 도구
ComfyUI 입문 실전 가이드 — 컴퓨터 사양부터 첫 이미지까지