ComfyUI에서 다른 사람이 공유한 JSON 파일을 열었는데 일부 노드가 사라지거나 Missing Nodes 경고가 뜨는 경우가 있다. 이때 JSON 파일 자체가 잘못됐다고 생각하기 쉽지만, 실제로는 해당 workflow가 사용한 custom node가 현재 ComfyUI 환경에 없는 경우를 먼저 확인해야 한다.
특히 인터넷에서 받은 workflow JSON은 기본 노드만으로 구성됐다고 보장할 수 없다. JSON 안에는 특정 노드를 사용했다는 정보가 남아 있어도 그 노드를 제공하는 확장 패키지가 설치되지 않았다면 동일한 workflow를 그대로 실행할 수 없다.
json 파일에서 가장 먼저 볼 변화
ComfyUI JSON 파일이 열려도 모든 노드가 있는 것은 아니다
ComfyUI workflow JSON은 그래프의 노드와 연결 상태를 저장할 수 있다. 하지만 custom node를 구현하는 Python 코드와 관련 패키지까지 JSON 파일 안에 포함하는 형식은 아니다.
따라서 JSON 파일을 다른 PC로 옮겨도 원래 환경에서 사용하던 custom node가 함께 이동하는 것은 아니다. workflow를 공유받은 사람이 같은 노드 패키지를 가지고 있지 않다면 불러오는 과정에서 missing node가 발생할 수 있다.
Missing Nodes가 보이면 먼저 확인할 것
가장 먼저 JSON 파일을 다시 다운로드할 필요는 없다. 어떤 노드가 누락됐는지를 확인하고 그 노드를 제공하는 custom node 패키지가 현재 설치되어 있는지 보는 것이 우선이다.
ComfyUI Manager가 정상적으로 설치된 환경에서는 missing node가 포함된 workflow를 불러올 때 관련 안내를 받을 수 있다. Manager에서 누락된 노드를 찾을 수 있다면 해당 패키지를 설치하는 방식으로 접근할 수 있다.
여기서 중요한 점은 JSON 파일과 custom node 설치 상태를 별개의 문제로 보는 것이다. 같은 JSON 파일이라도 한 PC에서는 정상적으로 열리고 다른 PC에서는 missing node가 발생할 수 있다.
ComfyUI Manager에서 누락된 노드를 찾지 못할 수도 있다
json 파일가 ComfyUI 워크플로우에 미치는 영향
Missing Nodes가 표시됐다고 해서 Manager에서 항상 해당 노드를 바로 찾을 수 있는 것은 아니다. 현재 ComfyUI의 새 Manager는 Registry를 기준으로 custom node를 관리한다.
기존 방식과 비교해야 할 부분
따라서 workflow가 사용하는 노드의 패키지가 Registry에 등록되어 있지 않다면 Manager 검색 결과에 나타나지 않을 수 있다. 이 경우 JSON이 잘못된 것이 아니라 자동으로 설치할 수 있는 패키지 정보가 없는 상황일 수 있다.
Manager에 검색되지 않는 경우
누락된 노드가 Manager에서 나오지 않는다면 몇 가지 가능성을 구분해야 한다. 해당 custom node가 Registry에 등록되지 않았거나, 기존 버전에서 제공되던 노드가 변경 또는 삭제된 경우가 있을 수 있다.
새 Manager에서 찾기 어려운 custom node는 필요에 따라 제작자가 안내한 설치 방식을 확인해야 한다. 공식 설치 문서에서도 Manager 외에 Git을 이용해 custom_nodes 디렉터리에 직접 설치하는 방법을 별도로 안내하고 있다.
즉 Missing Nodes 창에서 Install All을 눌렀는데 해결되지 않았다고 해서 workflow JSON을 바로 포기할 필요는 없다. 어떤 custom node 저장소에서 해당 노드를 제공했는지를 추적하는 단계가 추가로 필요할 수 있다.
설치했는데도 Missing Nodes가 남는 이유
custom node를 설치했는데도 같은 노드가 계속 missing으로 표시될 때는 단순 미설치가 아닌 다른 문제를 확인해야 한다. 대표적인 것이 custom node 로딩 실패와 의존성 문제다.
성능과 결과 품질에서 확인할 차이
ComfyUI 공식 문제 해결 문서에서도 custom node와 관련된 Failed to import 오류, 설치 후에도 사라지지 않는 missing node, 의존성 충돌 등을 별도의 문제로 다룬다. 패키지 폴더가 존재하는 것만으로 해당 노드가 정상적으로 로드됐다고 볼 수는 없다.
워크플로우 구성에서 놓치기 쉬운 부분
ComfyUI 재시작과 로그도 확인한다
custom node 설치 후에는 ComfyUI를 다시 시작해 실제로 패키지가 로드되는지 확인하는 것이 좋다. 재시작 후에도 노드가 없다면 시작 로그에서 해당 custom node의 import 실패 메시지가 있는지 살펴볼 필요가 있다.
일부 custom node는 추가 Python 패키지를 요구하거나 특정 dependency 버전을 요구할 수 있다. 이런 의존성 설치가 실패하면 custom node 폴더가 존재해도 ComfyUI에서는 해당 노드를 사용할 수 없다.
특히 ComfyUI 본체를 업데이트한 직후 문제가 발생했다면 custom node도 함께 호환되는 버전인지 확인할 필요가 있다. ComfyUI 업데이트와 custom node의 프론트엔드 또는 의존성 변화가 맞지 않으면 기존 workflow가 정상적으로 동작하지 않을 수 있다.
JSON 파일을 다시 받기 전에 확인할 순서
공유받은 workflow JSON에서 Missing Nodes가 나타난다면 확인 순서를 단순하게 잡는 편이 빠르다.
어떤 노드가 Missing 상태인지 확인
실제로 적용할 때 체크할 점
ComfyUI Manager에서 해당 custom node 검색
Manager에서 찾을 수 없다면 제작자 저장소와 설치 방법 확인
설치 후 ComfyUI 재시작
여전히 없다면 시작 로그의 Failed to import와 dependency 오류 확인
JSON 파일을 다시 받거나 workflow를 처음부터 만드는 것은 그 다음 단계다. 누락된 노드만 정상적으로 복원하면 기존 JSON 그래프를 계속 사용할 수 있는 경우가 있기 때문이다.
마지막 확인
ComfyUI JSON 파일을 불러왔을 때 Missing Nodes가 뜬다면 먼저 파일 손상보다 실행 환경 차이를 의심하는 것이 좋다. workflow JSON과 그 workflow가 의존하는 custom node는 서로 다른 구성 요소다.
지금 받은 JSON이 열리지 않는다면 누락된 노드 이름부터 확인하고 Manager에서 설치 가능 여부를 찾아보자. 이미 설치했다면 ComfyUI 재시작과 시작 로그를 확인해 실제로 custom node가 로드됐는지를 보는 것이 다음 순서다.