ComfyUI 플러그인 가져오기 실패: 커스텀 노드 로드 에러 해결법

ComfyUI 플러그인 가져오기 실패(IMPORT FAILED) 에러, 깨진 커스텀 노드 임포트, 워크플로의 붉은색 노드 및 의존성 버전 충돌 해결법.

테스트 환경

운영체제: Windows 10 / 11
실행기: Wonderful Launcher v1.x
ComfyUI: 포터블 버전 / 관리형 설치
Python: 3.11+
CUDA / Torch: CUDA 12.x / Torch 2.x
마지막 테스트일: 2026-05-19

구글에 **comfyui plugin import failed**를 검색했거나, 서버 시작 로그에 IMPORT FAILED 경고가 기록된 경우, 본 가이드는 브라우저 통신 장애나 매니저 오류가 아닌 오직 커스텀 노드 임포트 실패 오류만 집중적으로 다룹니다.

만약 브라우저에 Failed to Save Workflow Draft 에러만 표시된다면, 이는 플러그인 로드 결함이 아닌 임시 저장 문제입니다. 먼저 ComfyUI 워크플로 초안 저장 실패 복구를 참조하여 워크플로를 보존하세요.

다운로드한 커스텀 노드가 ComfyUI에서 불러와지지 않는다면 플러그인 폴더 자체는 존재하나, 서버를 실행 중인 Python 프로세스가 해당 플러그인의 코드를 정상적으로 로드하지 못했음을 뜻합니다.

comfyui plugin import failed 오류 해결의 요약 답변은 다음과 같습니다.

먼저 어떤 특정 플러그인이 로드 실패했는지 터미널의 Traceback 오류 로그를 정확히 확인합니다.
나중에 인지한 붉은색 노드를 쫓아다니지 말고, 가장 먼저 로드 실패가 보고된 최초의 에러부터 해결하세요.
패키지를 섣불리 전역 시스템에 설치하지 말고, 오직 ComfyUI를 가동하는 정확한 Python 가상환경에만 설치합니다.
이 오류는 전체 프로그램의 영구 파손이 아닌, 대부분의 경우 단순한 라이브러리 충돌이나 유실에 기인합니다.

보통 아래의 4가지 원인 중 하나에 해당합니다.

필수 Python 패키지 누락
특정 플러그인이 타 노드와 호환되지 않는 버전의 패키지를 덮어씀
Torch 등 핵심 딥러닝 런타임 패키지 버전 강제 강하(Downgrade)
플러그인 리포지토리의 소스 코드 누락이나 손상

대표적인 플러그인 임포트 실패 상황

장애 로그 통계상 가장 발생 비율이 높은 핵심 플러그인 임포트 에러 유형은 다음과 같습니다.

임포트 에러 키워드	원인	권장 해결 가이드
`No module named 'insightface'`	얼굴 인식/교체 노드 필수 라이브러리 유실	ComfyUI InsightFace 누락
`No module named 'onnx'` 또는 `onnxruntime`	DWPose, ReActor 등 ONNX 추론 기반 노드 필수 패키지 유실	ComfyUI ONNX / ONNXRuntime 누락
`No module named 'triton'`	가속화 연산 라이브러리 유실	ComfyUI Triton 누락 또는 사용 불가
`No module named 'llama_cpp'`	로컬 LLM/프롬프트 보조 노드 패키지 유실	ComfyUI llama_cpp 누락
`No module named 'nunchaku'`	Nunchaku FLUX 등 양자화 노드 패키지 유실	ComfyUI Nunchaku 누락
ComfyUI 내부 `AttributeError` 발생	플러그인 버전과 ComfyUI 버전 간의 규격 불일치	패키지 재설치가 아닌 플러그인 코드 업데이트 필요
`Failed to Save Workflow Draft`	브라우저상의 워크플로 저장망 차단	먼저 워크플로 JSON 저장

오류 현상의 레이어(Layer)를 올바르게 구분해야 시간을 아낄 수 있습니다.

증상 구분	실제 상태
워크플로상 노드가 붉은색으로 표기됨	워크플로 파일이 가리키는 노드가 현재 서버에 미등록된 상태
서버 기동 시 `IMPORT FAILED` 기록됨	커스텀 노드 폴더는 존재하나 Python이 코드 임포트에 실패함
실행 버튼(Queue) 클릭 시에만 에러가 남	노드 등록은 되었으나 모델 부재, CUDA 호출 에러, 혹은 런타임 연산 에러 발생

최초 등록 실패 레이어부터 차근차근 확인하십시오. 노드가 아예 등록조차 안 된 상태라면, 연산 관련 패키지를 설치해 봐야 붉은색 노드 경고가 사라지지 않습니다.

플러그인 로드 오류가 나더라도 ComfyUI를 재설치할 필요는 전혀 없습니다. 대부분 환경 정보와 라이브러리만 살짝 복원하면 기존 작업물과 모델들을 그대로 보존해 사용할 수 있습니다.

"플러그인 가져오기 실패" 로그 분석

대개 터미널 시작 로그에 아래와 같이 IMPORT FAILED와 함께 ModuleNotFoundError 등이 자세하게 출력됩니다.

IMPORT FAILED: ComfyUI-ExampleNode
Traceback (most recent call last):
  File "...\custom_nodes\ComfyUI-ExampleNode\__init__.py", line 4, in <module>
    import somepackage
ModuleNotFoundError: No module named 'somepackage'

또는 다음과 같이 DLL 오류가 발생할 수도 있습니다.

IMPORT FAILED: ComfyUI-AnotherNode
ImportError: DLL load failed while importing cv2

1단계: 실패한 노드 및 에러 유형 식별

인터넷 검색 창에서 본 명령을 마구잡이로 긁어다 실행하기 전에 먼저 파악하십시오.

임포트에 실패한 정확한 플러그인 폴더명은 무엇인가?
로드를 차단한 정확한 Python 예외 오류(Exception) 종류는 무엇인가?

다음 경로들을 통해 수집합니다.

서버 기동 터미널 로그: 가장 위쪽의 IMPORT FAILED와 그 아래 Traceback 오류 추적을 끝까지 확인합니다.
가져오기 실패 JSON API: 서버가 켜진 상태라면 아래 주소에 접근해 실패한 노드 목록을 한눈에 수집할 수 있습니다.
```
http://127.0.0.1:8188/v2/customnode/import_fail_info_bulk
```

완료 판단: 폴더 존재만으로는 충분하지 않습니다

최근 사례를 보면, 플러그인 폴더가 있거나 Python에서 패키지 하나를 가져올 수 있다는 이유만으로 복구가 끝났다고 판단하기 쉽습니다. 그러나 그것은 ComfyUI 노드가 실제로 등록되었다는 증거가 아닙니다.

확인된 상태	증명하는 것	아직 증명하지 않는 것
`custom_nodes/` 아래에 플러그인 폴더가 있음	파일이 존재함	플러그인 가져오기가 성공함
`python -c "import package"` 성공	한 Python 패키지가 오프라인에서 import됨	ComfyUI가 같은 Python을 사용하거나 노드를 등록함
시작 로그에 해당 플러그인의 `IMPORT FAILED`가 없음	시작 단계의 import를 통과함	워크플로에 필요한 모델과 입력이 모두 있음
`/v2/customnode/import_fail_info_bulk`에서 해당 플러그인이 깨끗함	백엔드에 기록된 import 실패가 없음	워크플로 실행 시 모델, CUDA, 입력 오류가 없음
재시작 후 붉은 노드가 사라짐	노드 클래스가 등록됨	모델 파일과 런타임 백엔드가 모두 준비됨

노드가 등록된 뒤 모델 파일이 없다는 오류가 나오면 모델 파일 위치 가이드 또는 모델을 찾을 수 없음으로 전환하세요. 플러그인을 계속 재설치하면 안 됩니다.

2단계: 오류 유형별 복구 방안

유형 A: 패키지 누락 (ModuleNotFoundError)

가장 보편적인 에러입니다. 플러그인이 실행하려는 라이브러리가 Python 가상환경에 없을 때 발생합니다. ComfyUI 전용 Python 환경 경로를 이용해 수동 설치해 줍니다.

설치 환경 구분	복구 실행 명령 형태
Standalone Windows 포터블 버전	포터블 루트 폴더에서: `.\python_embeded\python.exe -s -m pip install <패키지명>`
수동 설치 환경 (Git + venv)	가상환경을 활성화한 뒤: `python -m pip install <패키지명>`
ComfyUI Desktop 및 타 실행기	앱 내장 통합 개발 콘솔 터미널 환경을 이용

유형 B: 깨진 바이너리 (DLL load failed)

패키지가 설치는 되어 있으나 런타임 DLL 파일이 깨졌거나 현재의 Python, CUDA 사양에 맞지 않는 휠(whl)이 들어가 있을 때 나타납니다. 대표적으로 cv2 (OpenCV) 오류가 이에 해당합니다. 기존 충돌 패키지를 uninstall 한 뒤, 적합한 prebuilt wheel을 설치해 주어야 합니다.

유형 C: 핵심 런타임 버전 훼손 (AttributeError)

특정 신규 노드를 깔면서 torch, numpy 등 핵심 패키지들의 안정된 가속 버전이 CPU 버전 등으로 잘못 덮어써져 충돌이 났을 때 발생합니다. 현재 Python 가상환경의 충돌 정보를 체크합니다.

pip check

버전이 꼬인 경우 핵심 PyTorch 런타임을 다시 올바른 CUDA 가속용 버전으로 복원해 주어야 합니다. 자세한 내용은 ComfyUI 의존성 충돌 가이드를 참조하십시오.

유형 D: 리포지토리 코드 자체 결함

깃허브 클론 단계에서 Git LFS 등의 파일이 유실되었거나, 플러그인 코드가 너무 오래되어 최신 ComfyUI 규격과 충돌이 나는 상태입니다. 해당 폴더로 이동해 코드를 pull 하여 업데이트해 봅니다.

cd custom_nodes/<플러그인폴더명>
git pull

그 뒤, 가급적이면 requirements.txt 전체를 무작정 install 하지 말고, 필요한 부족 라이브러리만 개별 설치하는 것이 핵심 가상환경을 훼손하지 않는 안전한 팁입니다.

포터블 패키지에서 해당 플러그인의 requirements가 꼭 필요하다면, 포터블 루트에서 다음처럼 내장 Python을 사용합니다.

.\python_embeded\python.exe -s -m pip install -r .\ComfyUI\custom_nodes\<plugin-name>\requirements.txt

그래도 다음 순서를 지키세요.

pip install -r requirements.txt를 무작정 실행하지 마세요.

활성 Python 환경을 확인합니다 (where python 또는 which python).
requirements.txt에 torch, numpy, opencv 버전 고정이 있는지 확인합니다.
가능한 경우 필요한 패키지만 설치합니다: pip install <package-name>.
설치 후 pip check로 새 충돌이 생기지 않았는지 확인합니다.

3단계: 명령줄 반복이 환경을 더 나쁘게 만드는 시점

수동 복구 자체는 가능하지만, 아래와 같은 순환이 반복되면 위험 신호입니다.

패키지 하나 설치
ComfyUI 재시작
새 import 실패 발견
다른 패키지 설치
Torch 또는 NumPy 충돌
무엇이 바뀌었는지 추적 불가

이 단계에서는 환경이 복구 가능한 상태여도 불필요한 재설치로 이어지기 쉽습니다.

단일 플러그인 문제가 아니라 의존성 충돌인 경우

패키지 설치 뒤 서로 관계없는 플러그인 여러 개가 동시에 실패하기 시작했다면, 더 이상 플러그인 하나만의 문제가 아닐 가능성이 큽니다. 이때는 ComfyUI 의존성 충돌과 포터블 ComfyUI 의존성을 한 번에 하나의 누락 모듈씩 복구하기로 전환하세요.

Wonderful Launcher가 도울 수 있는 부분

Wonderful Launcher는 실제로 실패한 ComfyUI 환경과 시작 로그를 가까이에서 확인하고, 플러그인 하나의 오류 때문에 광범위한 패키지 변경을 하지 않도록 복구 순서를 안내합니다. 복잡한 플러그인 스택은 여전히 수동 확인이 필요할 수 있습니다.

전문가 도움으로 전환할 시점

다음 중 하나라면 더 많은 명령을 시도하기보다 전체 로그와 환경 정보를 보존한 뒤 복구 경로를 검토하세요.

서로 관계없는 플러그인이 여러 개 동시에 실패함
플러그인 복구 뒤 시작 실패가 발생함
이전 시도에서 Torch, CUDA, OpenCV가 이미 변경됨
원인이 저장소, 환경, 워크플로 중 어디인지 구분할 수 없음

출처 참조

실제 ComfyUI 환경에서 생긴 문제라면 먼저 무료로 Wonderful Launcher 로 현재 머신을 확인하세요. 런처 안의 복구 흐름, 작업 로그, 실행 환경 점검을 한곳에서 볼 수 있습니다. 크레딧은 이미지 생성과 사용량 기반 도구용입니다.

Wonderful Launcher 다운로드 크레딧 요금제 보기

Did this fix your issue?

Your answer helps prioritize verified ComfyUI repairs.

테스트 환경

운영체제: Windows 10 / 11
실행기: Wonderful Launcher v1.x
ComfyUI: 포터블 버전 / 관리형 설치
Python: 3.11+
CUDA / Torch: CUDA 12.x / Torch 2.x
마지막 테스트일: 2026-05-19

comfyui plugin import failed 오류 해결의 요약 답변은 다음과 같습니다.

먼저 어떤 특정 플러그인이 로드 실패했는지 터미널의 Traceback 오류 로그를 정확히 확인합니다.
나중에 인지한 붉은색 노드를 쫓아다니지 말고, 가장 먼저 로드 실패가 보고된 최초의 에러부터 해결하세요.
패키지를 섣불리 전역 시스템에 설치하지 말고, 오직 ComfyUI를 가동하는 정확한 Python 가상환경에만 설치합니다.
이 오류는 전체 프로그램의 영구 파손이 아닌, 대부분의 경우 단순한 라이브러리 충돌이나 유실에 기인합니다.

보통 아래의 4가지 원인 중 하나에 해당합니다.

필수 Python 패키지 누락
특정 플러그인이 타 노드와 호환되지 않는 버전의 패키지를 덮어씀
Torch 등 핵심 딥러닝 런타임 패키지 버전 강제 강하(Downgrade)
플러그인 리포지토리의 소스 코드 누락이나 손상

대표적인 플러그인 임포트 실패 상황

장애 로그 통계상 가장 발생 비율이 높은 핵심 플러그인 임포트 에러 유형은 다음과 같습니다.

임포트 에러 키워드	원인	권장 해결 가이드
`No module named 'insightface'`	얼굴 인식/교체 노드 필수 라이브러리 유실	ComfyUI InsightFace 누락
`No module named 'onnx'` 또는 `onnxruntime`	DWPose, ReActor 등 ONNX 추론 기반 노드 필수 패키지 유실	ComfyUI ONNX / ONNXRuntime 누락
`No module named 'triton'`	가속화 연산 라이브러리 유실	ComfyUI Triton 누락 또는 사용 불가
`No module named 'llama_cpp'`	로컬 LLM/프롬프트 보조 노드 패키지 유실	ComfyUI llama_cpp 누락
`No module named 'nunchaku'`	Nunchaku FLUX 등 양자화 노드 패키지 유실	ComfyUI Nunchaku 누락
ComfyUI 내부 `AttributeError` 발생	플러그인 버전과 ComfyUI 버전 간의 규격 불일치	패키지 재설치가 아닌 플러그인 코드 업데이트 필요
`Failed to Save Workflow Draft`	브라우저상의 워크플로 저장망 차단	먼저 워크플로 JSON 저장

오류 현상의 레이어(Layer)를 올바르게 구분해야 시간을 아낄 수 있습니다.

증상 구분	실제 상태
워크플로상 노드가 붉은색으로 표기됨	워크플로 파일이 가리키는 노드가 현재 서버에 미등록된 상태
서버 기동 시 `IMPORT FAILED` 기록됨	커스텀 노드 폴더는 존재하나 Python이 코드 임포트에 실패함
실행 버튼(Queue) 클릭 시에만 에러가 남	노드 등록은 되었으나 모델 부재, CUDA 호출 에러, 혹은 런타임 연산 에러 발생

"플러그인 가져오기 실패" 로그 분석

대개 터미널 시작 로그에 아래와 같이 IMPORT FAILED와 함께 ModuleNotFoundError 등이 자세하게 출력됩니다.

IMPORT FAILED: ComfyUI-ExampleNode
Traceback (most recent call last):
  File "...\custom_nodes\ComfyUI-ExampleNode\__init__.py", line 4, in <module>
    import somepackage
ModuleNotFoundError: No module named 'somepackage'

또는 다음과 같이 DLL 오류가 발생할 수도 있습니다.

IMPORT FAILED: ComfyUI-AnotherNode
ImportError: DLL load failed while importing cv2

1단계: 실패한 노드 및 에러 유형 식별

인터넷 검색 창에서 본 명령을 마구잡이로 긁어다 실행하기 전에 먼저 파악하십시오.

임포트에 실패한 정확한 플러그인 폴더명은 무엇인가?
로드를 차단한 정확한 Python 예외 오류(Exception) 종류는 무엇인가?

다음 경로들을 통해 수집합니다.

서버 기동 터미널 로그: 가장 위쪽의 IMPORT FAILED와 그 아래 Traceback 오류 추적을 끝까지 확인합니다.
가져오기 실패 JSON API: 서버가 켜진 상태라면 아래 주소에 접근해 실패한 노드 목록을 한눈에 수집할 수 있습니다.
```
http://127.0.0.1:8188/v2/customnode/import_fail_info_bulk
```

완료 판단: 폴더 존재만으로는 충분하지 않습니다

확인된 상태	증명하는 것	아직 증명하지 않는 것
`custom_nodes/` 아래에 플러그인 폴더가 있음	파일이 존재함	플러그인 가져오기가 성공함
`python -c "import package"` 성공	한 Python 패키지가 오프라인에서 import됨	ComfyUI가 같은 Python을 사용하거나 노드를 등록함
시작 로그에 해당 플러그인의 `IMPORT FAILED`가 없음	시작 단계의 import를 통과함	워크플로에 필요한 모델과 입력이 모두 있음
`/v2/customnode/import_fail_info_bulk`에서 해당 플러그인이 깨끗함	백엔드에 기록된 import 실패가 없음	워크플로 실행 시 모델, CUDA, 입력 오류가 없음
재시작 후 붉은 노드가 사라짐	노드 클래스가 등록됨	모델 파일과 런타임 백엔드가 모두 준비됨

2단계: 오류 유형별 복구 방안

유형 A: 패키지 누락 (ModuleNotFoundError)

설치 환경 구분	복구 실행 명령 형태
Standalone Windows 포터블 버전	포터블 루트 폴더에서: `.\python_embeded\python.exe -s -m pip install <패키지명>`
수동 설치 환경 (Git + venv)	가상환경을 활성화한 뒤: `python -m pip install <패키지명>`
ComfyUI Desktop 및 타 실행기	앱 내장 통합 개발 콘솔 터미널 환경을 이용

유형 B: 깨진 바이너리 (DLL load failed)

유형 C: 핵심 런타임 버전 훼손 (AttributeError)

pip check

유형 D: 리포지토리 코드 자체 결함

cd custom_nodes/<플러그인폴더명>
git pull

포터블 패키지에서 해당 플러그인의 requirements가 꼭 필요하다면, 포터블 루트에서 다음처럼 내장 Python을 사용합니다.

.\python_embeded\python.exe -s -m pip install -r .\ComfyUI\custom_nodes\<plugin-name>\requirements.txt

그래도 다음 순서를 지키세요.

pip install -r requirements.txt를 무작정 실행하지 마세요.

활성 Python 환경을 확인합니다 (where python 또는 which python).
requirements.txt에 torch, numpy, opencv 버전 고정이 있는지 확인합니다.
가능한 경우 필요한 패키지만 설치합니다: pip install <package-name>.
설치 후 pip check로 새 충돌이 생기지 않았는지 확인합니다.

3단계: 명령줄 반복이 환경을 더 나쁘게 만드는 시점

수동 복구 자체는 가능하지만, 아래와 같은 순환이 반복되면 위험 신호입니다.

패키지 하나 설치
ComfyUI 재시작
새 import 실패 발견
다른 패키지 설치
Torch 또는 NumPy 충돌
무엇이 바뀌었는지 추적 불가

이 단계에서는 환경이 복구 가능한 상태여도 불필요한 재설치로 이어지기 쉽습니다.

서로 관계없는 플러그인이 여러 개 동시에 실패함
플러그인 복구 뒤 시작 실패가 발생함
이전 시도에서 Torch, CUDA, OpenCV가 이미 변경됨
원인이 저장소, 환경, 워크플로 중 어디인지 구분할 수 없음

출처 참조

Wonderful Launcher 다운로드 크레딧 요금제 보기

Did this fix your issue?

Your answer helps prioritize verified ComfyUI repairs.

ComfyUI 플러그인 가져오기 실패: 커스텀 노드 로드 에러 해결법

대표적인 플러그인 임포트 실패 상황

"플러그인 가져오기 실패" 로그 분석

1단계: 실패한 노드 및 에러 유형 식별

완료 판단: 폴더 존재만으로는 충분하지 않습니다

2단계: 오류 유형별 복구 방안

유형 A: 패키지 누락 (ModuleNotFoundError)

유형 B: 깨진 바이너리 (DLL load failed)

유형 C: 핵심 런타임 버전 훼손 (AttributeError)

유형 D: 리포지토리 코드 자체 결함

3단계: 명령줄 반복이 환경을 더 나쁘게 만드는 시점

단일 플러그인 문제가 아니라 의존성 충돌인 경우

Wonderful Launcher가 도울 수 있는 부분

전문가 도움으로 전환할 시점

관련 가이드

출처 참조

목차

ComfyUI 플러그인 가져오기 실패: 커스텀 노드 로드 에러 해결법

대표적인 플러그인 임포트 실패 상황

"플러그인 가져오기 실패" 로그 분석

1단계: 실패한 노드 및 에러 유형 식별

완료 판단: 폴더 존재만으로는 충분하지 않습니다

2단계: 오류 유형별 복구 방안

유형 A: 패키지 누락 (ModuleNotFoundError)

유형 B: 깨진 바이너리 (DLL load failed)

유형 C: 핵심 런타임 버전 훼손 (AttributeError)

유형 D: 리포지토리 코드 자체 결함

3단계: 명령줄 반복이 환경을 더 나쁘게 만드는 시점

단일 플러그인 문제가 아니라 의존성 충돌인 경우

Wonderful Launcher가 도울 수 있는 부분

전문가 도움으로 전환할 시점

관련 가이드

출처 참조

목차