ComfyUI Plugin Import Failed: 커스텀 노드 로드 실패 복구

ComfyUI 는 뜨는데 커스텀 노드만 안 보인다면, 보통은 다운로드 실패보다 ComfyUI 를 시작한 Python 이 그 플러그인을 import 하지 못한 것 에 가깝습니다.

검색어가 comfyui plugin import failed 라면 짧은 답은 이렇습니다.

• 정확히 어떤 플러그인이 실패했는지 traceback 부터 본다
• 나중에 보이는 빨간 노드보다 첫 번째 import failure 를 먼저 고친다
• 패키지는 반드시 ComfyUI 가 쓰는 Python 에 넣는다
• 이 문제를 먼저 의존성 / 패키징 문제로 본다

서로 다른 증상 구분

자주 보이는 원인

• 필요한 Python 패키지 누락
• 어떤 플러그인이 공유 의존성을 망침
• Torch 같은 코어 패키지가 바뀜
• repo 가 오래됐거나 부분 설치 상태

먼저 할 일

1. 시작 로그 확인

IMPORT FAILED 와 전체 traceback 을 복사하세요.

2. import failure API 확인

UI 가 뜬다면:

http://127.0.0.1:8188/v2/customnode/import_fail_info_bulk

3. 고장 범위 보기

• 한 플러그인만 빠졌는지
• 여러 무관한 플러그인이 같이 빠졌는지
• 다른 플러그인 설치 후부터 깨졌는지

수동 복구 원칙

• 부족한 패키지라면 그 패키지만 먼저 넣기
• pip check 로 충돌 확인하기
• Torch / CUDA 가 깨졌다면 코어 runtime 부터 복구하기
• 모델과 workflow 는 최대한 보존하기

관련 문서

• ComfyUI No Module Named
• Dependency Conflicts
• Common Issues