ComfyUI 모델 경로 인식 실패: extra_model_paths.yaml 설정법
ComfyUI에서 외부 저장소 모델 경로가 감지되지 않는 오류, extra_model_paths.yaml 로드 실패, 윈도우 경로 구분자 및 드롭다운 목록 유실 해결법.
커뮤니티 지식
본 페이지의 문제 해결 대책은 보편적인 ComfyUI 구성 정보에 기반하며, 개별 특수 환경에서는 다르게 동작할 수 있습니다. 파일을 변경하기 전에 먼저 원본 환경 설정을 백업하십시오.
다운로드한 학습 모델 파일(.safetensors 등)이 하드디스크에 엄연히 존재함에도, ComfyUI의 노드 모델 선택 목록(Load Checkpoint 등)에 나타나지 않거나 extra_model_paths.yaml 로드 예외가 뜬다면 아래 복구 단계를 점검해 보십시오.
요약 답변
- 학습 파일이
ComfyUI/models/경로의 정확한 하위 폴더(예: checkpoints) 내에 위치하는지 검증합니다. - 외장 HDD/SSD 경로를 직접 맵핑할 때는
extra_model_paths.yaml파일의 들여쓰기 띄어쓰기 규격과 구분자 방향을 확인합니다. - 가장 중요: 경로 설정 정보를 바꾼 후에는 반드시 ComfyUI 가상환경을 완전히 재기동해야 새로고침 인식이 반영됩니다 (경로 스캔은 시작 시에만 동작).
외부 저장소 연결 점검 항목
| 체크 항목 | 정상 상태 | 비정상 시 조치 방향 |
|---|---|---|
편집하려는 extra_model_paths.yaml 파일이 구동 중인 ComfyUI의 것이 맞음 | 콘솔창 시작 폴더 경로와 일치함 | 백업용 복사본이 아닌, 현재 구동 프로세스가 물고 있는 폴더 내 파일을 편집 |
extra_model_paths.yaml이 ComfyUI 폴더 루트에 위치함 | main.py 파일과 같은 디렉토리에 있음 (models 내부가 아님) | 먼저 extra_model_paths.yaml.example 파일을 복사해 확장자명을 지움 |
| YAML 안의 들여쓰기에 탭(Tab)키가 쓰이지 않음 | 오직 반각 스페이스(공백)로만 들여쓰기 됨 | 탭 문자열을 모두 스페이스 공백으로 변환 |
경로 구분 기호에 백슬래시(\)가 쓰이지 않음 | 슬래시(/) 기호가 쓰임 | D:/AI/models 처럼 슬래시 방향으로 통일 |
| 외장 하드 드라이브 문자가 올바르고 폴더명이 맞음 | 외장 경로 아래 checkpoints/ 등이 물리적으로 실존함 | 외장 장치가 연결 해제되었는지, 드라이브 알파벳 문자가 밀렸는지 확인 |
원인 분석
- YAML 구문 규칙 위반: YAML 포맷은 인덴트(들여쓰기) 공백 제약이 엄격하여, Tab키가 한 글자라도 섞이면 전체 해석에 실패합니다.
- 경로 구분자 표기법 에러: 윈도우 표준 백슬래시(
\)는 파이썬에서 특수 문자로 오해하기 쉬우므로, 반드시 일반 슬래시(/) 방향으로 표기해야 합니다. - 외장 하드 미인식: PC 재부팅 과정에서 외장 하드 드라이브 문자(예: D에서 E로 변경)가 달라져 경로가 유실됨.
- models/ 폴더 바로 밑에 방치: 학습 모델은 반드시 해당 종류 폴더(
checkpoints/,loras/등) 아래에 놓여야 감지되며, 묶음 폴더 바로 밑에 두면 스킵됩니다.
조치 단계
1단계: 표준 모델 배치 폴더 확인
정석적인 기본 위치에 파일이 있는지 점검합니다.
dir ComfyUI\models\checkpoints\
dir ComfyUI\models\loras\여기에 파일이 존재함에도 읽어 들이지 못한다면, ComfyUI 서버 프로세스를 재시작하십시오.
2단계: extra_model_paths.yaml 구문 검증
외부 대용량 드라이브 연결을 위해 ComfyUI/extra_model_paths.yaml 파일을 편집할 때의 포맷 규칙입니다.
올바른 표기법 예시:
my_models:
base_path: D:/AI/models
checkpoints: checkpoints/
loras: loras/
vae: vae/자주 저지르는 오류 사례:
# 에러: 탭(Tab)키로 들여쓰기 함
my_models:
base_path: D:/AI/models # 탭 문자 혼입 (오류 발생)
# 에러: 백슬래시 표기 및 폴더 슬래시 누락
my_models:
base_path: D:\AI\models # 백슬래시 사용 불가
checkpoints: checkpoints # 하위 경로 끝 슬래시 누락
# 에러: 실존하지 않는 드라이브 가리킴
my_models:
base_path: E:/Models # 외장 E드라이브가 PC에 잡히지 않음3단계: 물리적 접근성 확인
파워셸 등에서 외장 경로가 정상 감지되는지 테스트합니다.
dir "D:\AI\models\checkpoints\"4단계: YAML 유효성 체크
- 띄어쓰기 들여쓰기 공백을 2칸 혹은 4칸으로 정렬합니다.
- 윈도우 경로명이라도 슬래시(
/) 방향을 씁니다. - 경로 중간에 빈 칸(띄어쓰기)이 들어간다면 큰따옴표로 묶어 줍니다:
base_path: "D:/My Models/AI"
5단계: ComfyUI 서버 프로세스 재시작
파일 저장을 마친 후 변경분을 불러오기 위해 서버를 다시 부팅합니다.
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build터미널 실행 로그상에 YAML 파싱 에러(Parsing error) 경고가 나오지 않는지 확인하세요.
관련 가이드
실제 ComfyUI 환경에서 생긴 문제라면 먼저 무료로 Wonderful Launcher 로 현재 머신을 확인하세요. 런처 안의 복구 흐름, 작업 로그, 실행 환경 점검을 한곳에서 볼 수 있습니다. 크레딧은 이미지 생성과 사용량 기반 도구용입니다.
Wonderful Launcher 다운로드크레딧 요금제 보기Did this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.
모델을 찾을 수 없음
ComfyUI가 모델, 체크포인트, LoRA, VAE, ControlNet, safetensors 파일을 찾지 못할 때 다운로드 누락, 잘못된 폴더, 모델 경로 설정 문제를 빠르게 확인합니다.
ComfyUI "Failed to Fetch": 어떤 연결이 실패했는지 찾기
ComfyUI가 Failed to Fetch를 표시하는 것은 브라우저가 유효한 응답을 받지 못했다는 뜻입니다. 설치를 바꾸기 전에 백엔드, Manager, Registry, WebSocket, 워크플로 초안, 프록시 중 어디가 실패했는지 먼저 확인하세요.