ComfyUI 의존성 패키지 충돌: 재설치 없이 해결 가이드

터미널창이나 부팅 도중 comfyui dependency conflicts, custom node broke environment, 또는 pip install broke comfyui 등 패키지가 꼬여 동작하지 않는 에러를 마주쳤다면, 다음 요약 답변을 먼저 읽어 보십시오.

전체 프로그램을 재설치하지 마십시오. 어떤 특정 플러그인 변경이나 라이브러리 추가 명령이 공유 가상환경 영역을 오염시켰는지 파악하고 가장 영향 범위가 좁은 단위로 복구 조치를 수행하는 것이 정석입니다.

만약 pip check 콘솔 진단 결과가 **sensevoice-onnx requires setuptools<=65.0**으로 명확하게 뜬다면, SenseVoice-ONNX setuptools 충돌 복구 가이드를 따라 핀포인트 최소 우회 조치만 취해주면 쉽게 해결됩니다.

의존성 충돌(Dependency Conflict)은 수많은 ComfyUI 환경의 보이지 않는 암살자입니다. 특정 신규 노드가 설치 과정 중 PyTorch, NumPy, OpenCV, 혹은 Hugging Face 관련 패키지 버전을 임의로 덮어쓰는 순간, 다른 노드들의 모듈 수집 경로가 파괴되어 어제까지 돌리던 워크플로가 오늘 갑자기 먹통이 됩니다.

꼬인 의존성을 안전하게 파악하고 정리하는 요령을 익혀 보십시오.

눈여겨봐 두어야 할 의존성 충돌 양상

발생 확률이 매우 높은 아래 패키지 꼬임 양상을 파악해 두면 오류 진단 시간을 획기적으로 줄일 수 있습니다.

신속 진단 요약

1단계: 진단 및 파악

가져오기 실패 분석

ComfyUI 서버 기동 시 출력되는 로그 중 IMPORT FAILED 라인을 복사하여 메모해 둡니다.

IMPORT FAILED: ComfyUI-ExampleNode
ModuleNotFoundError: No module named 'somepackage'

pip check 도구 사용

ComfyUI 가동에 쓰이는 정확한 Python 실행 파일 경로를 이용하여 의존성 충돌 현황을 질의합니다.

출력 결과물 예시:

some-plugin 1.0 requires numpy<2, but you have numpy 2.4.4

2단계: 문제 분류

부류 A: 치명적 장애 (즉시 조치 필요)

• torch 가속 버전이 CPU 전용 버전으로 강하되어 GPU 인식이 안 될 때.
• 현재 실행해야 하는 워크플로 핵심 노드가 IMPORT FAILED 상태일 때.
• OpenCV(cv2) DLL 수집 실패로 인해 시작 자체가 안 될 때.

부류 B: 소프트 충돌 (조치 없이 방치 권장)

• pip check에서 특정 버전 충돌 경고가 연달아 출력되고 있으나, 정작 ComfyUI 실행도 잘 되고 이미지 생성 렌더링도 오류 없이 진행될 때.
• 황금 규칙: 프로그램 동작에 아무 이상이 없다면, 단순히 pip check 문구를 깨끗하게 비우려고 라이브러리를 삭제/재설치하여 가상환경을 위험에 노출시키지 마십시오.

3단계: 복원 규칙

규칙 1: 런타임 핵심 패키지 방어

torch, numpy, pillow, opencv-python 등은 가상환경의 최상위 포식자 패키지입니다. 신규 노드 requirements가 이들을 임의로 덮어쓰지 못하게 가상설치를 해 봅니다.

python -m pip install -r requirements.txt --dry-run

만약 Torch나 NumPy 등이 덮어써지려고 뜬다면, 명령을 즉시 중단하고 수동 개별 라이브러리 설치로 선회하십시오.

규칙 2: 구동 파이썬 환경 정확히 인지

엉뚱한 시스템 전역 Python 경로에 라이브러리를 설치하는 실수를 범하지 마십시오.

관련 가이드

• Torch를 다시 설치하지 않고 손상된 ComfyUI 포터블 의존성 복구
• ComfyUI 플러그인 가져오기 실패 복구
• ComfyUI 의존성 충돌
• 커스텀 노드 안전하게 설치하기
• ComfyUI에서 Safetensors 파일을 둘 위치