메인 콘텐츠로 건너뛰기
다음은 맞춤형 노드 문제를 해결하기 위한 전반적인 접근법입니다:

​
모든 맞춤형 노드를 비활성화하는 방법?

설정 메뉴에서 맞춤형 노드를 비활성화한 상태로 ComfyUI 데스크탑을 시작하세요설정 메뉴 - 맞춤형 노드 비활성화또는 서버를 수동으로 실행하세요:
cd path/to/your/comfyui
python main.py --disable-all-custom-nodes
결과:
  • ✅ 문제 사라짐: 맞춤형 노드가 문제를 일으키고 있음 → 2단계로 진행
  • ❌ 문제 지속: 맞춤형 노드 문제가 아님 → 문제 보고

​
이진 탐색이란?

이 문서에서는 맞춤형 노드 문제 해결을 위한 이진 탐색 방식을 소개합니다. 이 방식은 맞춤형 노드를 두 개씩 나누어 절반씩 검사하며 문제 노드를 찾아가는 것입니다. 구체적인 방법은 아래 플로차트를 참고하세요 - 현재 비활성화된 노드 중 절반을 활성화하고 문제가 나타나는지 확인하며, 어느 맞춤형 노드가 문제를 일으키는지 찾아갑니다.

​
두 가지 문제 해결 방법

이 문서에서는 맞춤형 노드를 두 가지 유형으로 구분해 문제 해결을 안내합니다: 맞춤형 노드 유형
  • A: 프론트엔드 확장 기능이 있는 맞춤형 노드
  • B: 일반 맞춤형 노드
먼저 각 유형의 맞춤형 노드가 가질 수 있는 문제와 원인을 알아보겠습니다:
맞춤형 노드 중에서도 프론트엔드 확장 기능이 있는 노드를 우선적으로 문제 해결해야 합니다. 이들은 가장 많은 문제를 일으키며, 주로 ComfyUI 프론트엔드 버전 업데이트와의 호환성 문제로 인해 발생합니다.일반적인 문제는 다음과 같습니다:
  • 워크플로 실행 불가
  • 일부 노드의 미리보기 이미지 표시 불가(예: 이미지 저장 노드)
  • UI 요소의 정렬 오류
  • ComfyUI 프론트엔드 접속 불가
  • UI 완전히 깨짐 또는 화면이 비어있음
  • ComfyUI 백엔드와 정상적으로 통신 불가
  • 노드 연결이 제대로 작동하지 않음
  • 그 외 다수
이러한 문제의 일반적인 원인은 다음과 같습니다:
  • 업데이트 과정에서 프론트엔드가 변경되었으나 맞춤형 노드가 아직 이를 따라가지 못한 경우
  • 작성자가 호환 가능한 버전을 출시했음에도 사용자가 ComfyUI를 업데이트하면서 맞춤형 노드도 동기화하지 않은 경우
  • 작성자가 유지보수를 중단해 맞춤형 노드 확장 기능과 ComfyUI 프론트엔드 간의 호환성이 깨진 경우

​
이진 탐색을 이용한 문제 해결

위 두 가지 유형의 맞춤형 노드 문제 중에서도 맞춤형 노드 프론트엔드 확장 기능과 ComfyUI 간의 충돌이 더 흔하게 발생합니다. 우리는 먼저 이 노드들을 우선적으로 문제 해결하겠습니다. 전체적인 문제 해결 방식은 다음과 같습니다:

​
1. 맞춤형 노드의 프론트엔드 확장 기능 문제 해결

1

모든 서드파티 프론트엔드 확장 기능 비활성화

모든 플러그인 프론트엔드 확장 기능 비활성화ComfyUI를 시작한 후 설정에서 Extensions 메뉴를 찾아 이미지에 표시된 단계를 따라 모든 서드파티 확장 기능을 비활성화하세요
ComfyUI 프론트엔드에 진입할 수 없다면 프론트엔드 확장 기능 문제 해결 부분을 건너뛰고 일반 맞춤형 노드 문제 해결 방식으로 넘어가세요
2

ComfyUI 재시작

첫 번째로 프론트엔드 확장 기능을 비활성화한 후, 모든 프론트엔드 확장 기능이 제대로 비활성화되었는지 확인하려면 ComfyUI를 재시작하는 것이 좋습니다
  • 문제가 사라졌다면 맞춤형 노드 프론트엔드 확장 기능이 원인이므로 이진 탐색을 통해 문제를 해결할 수 있습니다
  • 문제가 지속된다면 프론트엔드 확장 기능이 원인이 아닙니다 - 이 문서의 다른 문제 해결 방식을 참고하세요
3

이진 탐색을 이용해 문제 노드 찾기

이 문서 앞부분에서 언급한 방법을 사용해 문제 노드를 찾으세요. 한 번에 맞춤형 노드의 절반을 활성화하며 문제가 되는 노드를 찾아갑니다프론트엔드 확장 기능 활성화이미지를 참고해 프론트엔드 확장 기능의 절반을 활성화하세요. 확장 기능 이름이 비슷하다면 대부분 같은 맞춤형 노드의 프론트엔드 확장 기능임을 의미합니다
4

후속 조치

문제가 되는 맞춤형 노드를 찾았다면 이 문서의 문제 해결 섹션을 참고해 맞춤형 노드 문제를 해결하세요
이 방법을 사용하면 ComfyUI를 여러 번 재시작할 필요가 없습니다 - 맞춤형 노드 프론트엔드 확장 기능을 활성화하거나 비활성화한 후 ComfyUI를 다시 로드하기만 하면 됩니다. 또한 문제 해결 범위가 프론트엔드 확장 기능이 있는 노드로 한정되므로 검색 범위가 크게 줄어듭니다.

​
2. 일반 맞춤형 노드 문제 해결

1

이진 탐색을 이용해 맞춤형 노드 찾기

이진 탐색을 이용한 위치 파악 방법에는 수동 검색 외에도 아래와 같이 comfy-cli를 이용한 자동 이진 탐색도 가능합니다:
Comfy CLI를 사용하려면 약간의 명령줄 경험이 필요합니다. 익숙하지 않다면 수동 이진 탐색을 사용하세요.Comfy CLI가 설치되어 있다면 자동 bisect 도구를 사용해 문제 노드를 찾을 수 있습니다:
# bisect 세션 시작
comfy-cli node bisect start

# 안내에 따라:
# - 현재 활성화된 노드 세트로 ComfyUI 테스트
# - 문제가 사라졌다면 'good'로 표시: comfy-cli node bisect good
# - 문제가 지속된다면 'bad'로 표시: comfy-cli node bisect bad
# - 문제가 발견될 때까지 반복

# 완료 시 초기화
comfy-cli node bisect reset
bisect 도구는 자동으로 노드를 활성화/비활성화하며 과정을 안내해줍니다.

​
문제 해결 방법

문제 노드를 찾았다면:

​
옵션 1: 노드 업데이트

  1. ComfyUI Manager에서 업데이트가 있는지 확인하세요
  2. 노드를 업데이트하고 다시 테스트하세요

​
옵션 2: 노드 교체

  1. 비슷한 기능을 가진 대체 맞춤형 노드를 찾아보세요
  2. ComfyUI 레지스트리에서 대체품을 확인하세요

​
옵션 3: 문제 보고

맞춤형 노드 개발자에게 연락하세요:
  1. 노드의 GitHub 리포지토리를 찾아보세요
  2. 다음 정보를 포함해 이슈를 생성하세요:
    • ComfyUI 버전
    • 오류 메시지/로그
    • 재현 단계
    • 운영체제

​
옵션 4: 노드 제거 또는 비활성화

해결 방법이 없고 기능이 필요하지 않다면:
  1. 문제가 되는 노드를 custom_nodes/에서 삭제하거나 ComfyUI Manager 인터페이스에서 비활성화하세요
  2. ComfyUI를 재시작하세요

​
문제 보고

맞춤형 노드가 원인이 아닌 문제라면 일반적인 문제 해결 개요를 참고해 다른 공통 문제를 해결하세요.

​
맞춤형 노드 특별 문제

맞춤형 노드 개발자에게 연락하세요:
  • 노드의 GitHub 리포지토리를 찾아보세요
  • ComfyUI 버전, 오류 메시지, 재현 단계, 운영체제를 포함해 이슈를 생성하세요
  • 노드의 문서와 이슈 페이지에서 이미 알려진 문제를 확인하세요

​
ComfyUI 핵심 문제

​
데스크탑 앱 문제

​
프론트엔드 문제

일반적인 설치, 모델 또는 성능 문제는 문제 해결 개요와 모델 문제 페이지를 참고하세요.