ComfyUI 설치 오류 해결 모음 — 안 열릴 때 확인할 것

ComfyUI를 받아서 실행 파일을 눌렀는데 검은 창만 지나가고 브라우저가 안 열립니다. 아니면 창이 몇 초 만에 그냥 닫힙니다. 처음 깔 때 가장 많이 만나는 상황입니다.

이럴 때 대부분 재설치부터 하는데, 다시 깔아도 같은 자리에서 같은 이유로 멈춥니다. 원인은 거의 항상 콘솔에 이미 찍혀 있습니다. 창이 너무 빨리 닫혀서 못 봤을 뿐입니다. 이 글은 그 로그를 어디서 보고 어떤 줄을 찾아야 하는지부터 정리합니다.

ComfyUI가 안 열릴 때 확인하는 순서 — 로그 파일, 주소와 포트, IMPORT FAILED, pip 대상 파이썬 — 순서대로만 보면 대부분 3번 안에서 끝납니다. 재설치는 맨 마지막입니다.

목차 (Table of Contents)

1. 로그 파일부터 엽니다

콘솔 창이 닫혀버렸어도 같은 내용이 파일로 남습니다. ComfyUI 설치 폴더 안의 user 폴더를 보세요.

ComfyUI\user\comfyui.log        ← 마지막 실행
ComfyUI\user\comfyui.prev.log   ← 그 전 실행

이 파일 맨 위 여섯 줄이 진단의 절반입니다. 실제 로그는 이렇게 생겼습니다.

** ComfyUI startup time: 2026-09-01 01:01:50
** Platform: Windows
** Python version: 3.11.14 (main, Feb  3 2026) [MSC v.1944 64 bit (AMD64)]
** Python executable: ...\ComfyUI\venv\Scripts\python.exe
** ComfyUI Path: ...\ComfyUI
** Log path: ...\ComfyUI\user\comfyui.log

여기서 Python executable 줄을 기억해 두세요. 뒤에서 패키지를 설치할 때 이 파이썬에 깔아야 합니다. 이 한 줄을 안 보고 그냥 pip install을 치는 것이 설치 오류의 가장 흔한 원인입니다.

로그 파일 자체가 없다면 ComfyUI가 시작조차 못 한 것입니다. 그때는 실행 배치 파일을 더블클릭하지 말고, 명령 프롬프트를 열어서 그 안에서 실행하세요. 창이 닫히지 않으니 오류 메시지를 읽을 수 있습니다.

2. 서버는 떴는데 화면이 안 나온다면 — 주소와 포트

로그를 아래로 내려서 이 줄이 있는지 봅니다.

Starting server
To see the GUI go to: http://127.0.0.1:8188

이 줄이 있으면 ComfyUI는 정상적으로 떠 있는 것입니다. 문제는 접속 쪽입니다. 확인할 것은 셋입니다.

주소를 로그에 찍힌 그대로 칩니다. 127.0.0.1:8188이 기본이지만 포트를 바꿔 실행했다면 숫자가 다릅니다.
https가 아니라 http입니다. 브라우저가 자동으로 https를 붙이면 연결이 안 됩니다.
8188 포트를 다른 프로그램이 이미 쓰고 있으면 ComfyUI가 뜨다가 죽습니다. 이때는 포트를 바꿔서 띄웁니다.

python main.py --port 8189

포트가 물려 있는지는 명령 프롬프트에서 바로 확인할 수 있습니다.

netstat -ano | findstr :8188

같은 PC가 아니라 다른 기기(휴대폰·노트북)에서 접속하려는 것이라면 주소만 바꿔서는 안 됩니다. ComfyUI는 기본적으로 자기 PC에서만 받도록 떠 있어서, --listen 을 붙여 실행해야 바깥에서 붙습니다. 다만 이건 내 PC를 네트워크에 여는 설정이므로 공용 와이파이에서는 권하지 않습니다.

3. 화면은 열리는데 노드가 없거나 이상하다면 — IMPORT FAILED

커스텀 노드 하나가 로딩에 실패하면 그 노드만 빠지는 게 아니라 화면 전체가 이상해지는 경우가 있습니다. 로그에서 이 단어 하나만 찾으면 됩니다.

IMPORT FAILED

로그 중간에 Import times for custom nodes: 로 시작하는 요약 블록이 있고, 실패한 노드는 거기에 표시가 붙어 나옵니다. 실제 로그에서 가져온 줄입니다.

Import times for custom nodes:
   0.0 seconds: ...\custom_nodes\comfyui_essentials
   0.0 seconds (IMPORT FAILED): ...\custom_nodes\ComfyUI-MMAudio
   0.1 seconds: ...\custom_nodes\comfyui-kjnodes

이유는 그 위쪽에 따로 찍혀 있습니다. 같은 실행에서 나온 것입니다.

File "...\custom_nodes\ComfyUI-MMAudio\nodes.py", line 5, in <module>
    from accelerate import init_empty_weights
ModuleNotFoundError: No module named 'accelerate'

Cannot import ...\custom_nodes\ComfyUI-MMAudio module for custom nodes:
No module named 'accelerate'

읽는 법은 단순합니다. ModuleNotFoundError: No module named 'X' 의 X가 없는 패키지이고, 바로 위 File 줄이 그걸 요구한 노드입니다. 여기서는 ComfyUI-MMAudio 가 accelerate 를 찾다가 실패한 것입니다.

고치는 방법은 그 노드 폴더의 requirements.txt를 설치하는 것인데, 반드시 1번에서 봐 둔 그 파이썬으로 설치해야 합니다.

venv\Scripts\python.exe -m pip install -r custom_nodes\ComfyUI-MMAudio\requirements.txt

당장 그 노드가 필요하지 않다면 더 빠른 방법이 있습니다. 폴더 이름 뒤에 .disabled 를 붙이거나 custom_nodes 밖으로 빼내면 ComfyUI가 읽지 않습니다. 문제 노드를 하나씩 빼면서 범인을 찾는 것도 이 방법입니다.

커스텀 노드를 계속 설치할 생각이라면 ComfyUI Manager 설치와 사용법을 먼저 갖춰두는 편이 낫습니다. 의존성 설치와 충돌 확인을 화면에서 처리해 줍니다.

4. pip를 어디에 깔았는지가 문제의 절반입니다

“분명히 설치했는데 없다고 나온다”는 상황은 거의 전부 다른 파이썬에 깔았기 때문입니다. 한 PC에 파이썬이 여러 개 있습니다 — 시스템 파이썬, ComfyUI 전용 venv, 포터블 버전의 내장 파이썬.

설치 형태	패키지를 깔아야 하는 파이썬
일반 설치(venv)	`ComfyUI\venv\Scripts\python.exe -m pip install ...`
윈도우 포터블	`python_embeded\python.exe -m pip install ...`
StabilityMatrix 등 런처	패키지 폴더 안의 `venv\Scripts\python.exe`

어느 쪽인지 헷갈리면 로그의 Python executable 줄이 곧 정답입니다. 그 경로를 그대로 복사해서 앞에 붙이고 -m pip install 을 이어 쓰면 틀릴 일이 없습니다.

5. 로그 문구별로 원인이 정해져 있습니다

ComfyUI 로그에 찍히는 오류 문구와 각각의 실제 원인, 조치 정리표 — 문구를 그대로 복사해서 찾으면 원인이 하나로 좁혀집니다.

표에 넣은 것 중 둘은 설명이 조금 더 필요합니다.

모델 파일이 깨진 경우

실행은 되는데 모델을 불러오는 순간 이 오류가 나면 파일이 다 안 받아진 것입니다.

!!! Exception during processing !!! Error while deserializing header:
incomplete metadata, file not fully covered

safetensors_rust.SafetensorError: Error while deserializing header:
incomplete metadata, file not fully covered

모델 파일은 몇 GB씩 되기 때문에 브라우저로 받다가 중간에 끊기는 일이 흔합니다. 그런데 끊겨도 파일은 남아 있어서 겉보기에는 정상으로 보입니다. 배포처에 적힌 용량과 실제 파일 크기를 비교해 보고, 다르면 지우고 다시 받으세요. 설치 오류가 아니라 다운로드 문제입니다.

모델은 있는데 목록에 안 뜨는 경우

이건 오류가 아니라 폴더를 잘못 넣은 것입니다. 체크포인트·LoRA·VAE는 각각 들어가야 할 자리가 따로 있고, 한 칸만 틀려도 노드 목록에 나타나지 않습니다. 어느 폴더에 무엇을 넣는지는 ComfyUI 폴더 구조와 모델 경로 정리에 표로 정리해 두었습니다.

6. 그래도 안 될 때

ComfyUI를 다시 설치하기 전에 확인할 항목 체크리스트 — 다시 깔기 전에 이 정도는 확인하는 편이 시간을 아낍니다.

특히 자주 놓치는 것이 브라우저 캐시입니다. 노드를 설치하거나 버전을 올린 뒤 화면이 깨져 보이면, 서버를 완전히 껐다 켠 다음 Ctrl+Shift+R로 강력 새로고침을 해 보세요. 광고 차단 확장이 화면 일부를 가리는 경우도 있어서, 시크릿 창에서 한 번 열어보면 확장 탓인지 금방 구분됩니다.

정말 다시 설치해야 하는 상황이라면 모델 폴더는 백업해 두세요. 용량이 크고 다시 받는 데 오래 걸리는데, 지우지 않아도 되는 경우가 대부분입니다.