1 point by slswlsek 3 weeks ago | flag | hide | 0 comments
ComfyUI 영상 업로드 실패 원인 및 해결을 위한 심층 분석 보고서
요약: 문제 해결을 위한 핵심 진단
ComfyUI에서 영상 업로드 시 발생하는 문제는 표면적으로는 단순한 파일 전송 오류처럼 보이지만, 실제로는 워크플로우 실행을 위한 백엔드 처리 과정에서 발생하는 복합적인 시스템 오류의 증상입니다. 따라서 이 문제를 해결하기 위해서는 사용자 인터페이스(UI) 상의 메시지가 아닌, 시스템의 내부 동작을 단계적으로 진단하는 체계적인 접근이 필수적입니다. 분석 결과, 영상 처리 실패의 가장 흔한 원인은 세 가지 범주로 분류할 수 있으며, 이들은 순서대로 점검하는 것이 가장 효율적입니다. FFmpeg 종속성 부재 또는 미설정: ComfyUI의 Load Video 노드를 비롯한 대부분의 영상 관련 기능은 외부 프로그램인 FFmpeg에 의존합니다. 이 프로그램이 시스템에 설치되어 있지 않거나 경로(PATH)가 올바르게 설정되지 않았을 경우, 영상 처리가 불가능해집니다. 이는 가장 흔하게 발생하는 오류이며, ffmpeg not found 또는 Codec not found와 같은 명확한 메시지를 통해 진단할 수 있습니다. 사용자 정의 노드 충돌: ComfyUI의 모듈식 아키텍처는 유연성을 제공하지만, 때로는 특정 사용자 정의 노드가 코어 기능 또는 다른 노드와 충돌하여 예기치 않은 오류를 유발할 수 있습니다. 특히 영상 관련 노드나 프런트엔드 확장 기능이 원인이 되는 경우가 많습니다. 영상 파일 자체의 문제: 사용자가 업로드하려는 영상 파일이 손상되었거나, 지원되지 않는 코덱 또는 형식을 사용하고 있을 수 있습니다. 본 보고서는 위의 세 가지 핵심 원인을 포함하여, 보다 심층적인 문제들까지 체계적으로 분석하고 해결 방안을 제시합니다.
ComfyUI에서 영상을 캔버스에 "업로드"하는 행위는 단순한 파일 복사 이상의 의미를 가집니다. 이 과정은 백엔드에서 Load Video 노드와 같은 특정 기능이 활성화되면서 시작되며, 이는 내부적으로 영상 파일의 압축을 해제하고 프레임별로 분리하는 복잡한 프로세스를 거칩니다. 따라서 사용자가 경험하는 "업로드 실패"는 사실상 파일 전송 자체의 문제가 아니라, 이처럼 뒤에서 진행되는 영상 처리 작업이 실패했음을 의미하는 진단 신호입니다. 이러한 백엔드 프로세스의 실패는 외부 종속성, 내부 소프트웨어 충돌, 또는 원본 파일 자체의 무결성 문제와 같은 다양한 원인에 기인할 수 있습니다. 본 보고서는 이러한 현상을 체계적인 관점에서 분석하여, 단순한 해결책을 넘어 사용자가 근본적인 문제의 원인을 이해하고 향후 유사한 문제를 스스로 해결할 수 있도록 돕는 데 목적을 둡니다. 이는 기술적으로 숙련된 사용자들에게 ComfyUI를 보다 안정적으로 운용할 수 있는 지식 기반을 제공할 것입니다.
이 단계에서는 영상 로드 실패의 가장 일반적이고 쉽게 해결할 수 있는 원인들을 다룹니다. 대부분의 경우, 문제는 이 범주 안에서 발견됩니다.
2.1. FFmpeg 종속성: 영상 처리의 핵심 엔진
ComfyUI 내에서 영상 파일을 다루는 거의 모든 프로세스는 FFmpeg이라는 외부 프로그램을 필요로 합니다. FFmpeg은 오픈 소스 기반의 강력한 명령줄 도구로, 영상 및 오디오 데이터의 디코딩, 인코딩, 포맷 변환과 같은 핵심 작업을 수행합니다. ComfyUI Unified Media Suite와 같은 사용자 정의 노드뿐만 아니라 VideoWriter와 같은 노드 역시 이 프로그램에 전적으로 의존합니다.1 따라서 FFmpeg이 시스템에 올바르게 설치되어 있지 않거나, ComfyUI가 해당 프로그램을 찾을 수 없다면 영상 관련 기능은 정상적으로 작동할 수 없습니다. 가장 명확한 증상은 터미널(명령 프롬프트) 로그에 나타나는 오류 메시지입니다. Codec not found 또는 ffmpeg was not found와 같은 오류 메시지는 FFmpeg 종속성 문제임을 직접적으로 나타냅니다.2 이는 백엔드 프로세스가 영상을 처리하기 위해 FFmpeg을 호출했으나, 시스템이 해당 명령어를 인식하지 못했음을 의미합니다. 설치 및 환경 변수(PATH) 설정 방법 Windows: FFmpeg은 기본적으로 ComfyUI에 포함되어 있지 않으므로 수동 설치가 필요합니다. 사용자는 공식 웹사이트에서 FFmpeg 실행 파일을 다운로드한 후, 압축을 해제하고 bin 폴더를 시스템의 환경 변수(PATH)에 추가해야 합니다.4 이 과정을 거치지 않으면 ComfyUI는 FFmpeg의 위치를 알 수 없어 오류를 발생시킵니다. 환경 변수 설정 후에는 터미널에서 ffmpeg -version을 입력하여 설치가 성공적으로 완료되었는지 확인할 수 있습니다. macOS: macOS에서는 Homebrew 패키지 관리자를 통해 brew install ffmpeg 명령어로 쉽게 설치할 수 있습니다.8 만약 이 방법으로도 문제가 해결되지 않는다면, 수동으로 FFmpeg 실행 파일을 다운로드하여 ComfyUI 설치 폴더 내부의 .venv/bin 폴더에 직접 배치해야 할 수 있습니다.9 이는 macOS의 보안 설정이 외부 실행 파일의 접근을 차단하는 것을 우회하는 방법입니다.9 숨김 파일을 표시하는 단축키인 command+shift+period를 활용하여 .venv 폴더를 찾아야 합니다. 영상 업로드 실패는 단순히 파일을 복사하는 과정이 아니라, Load Video 노드가 FFmpeg을 호출하여 영상 데이터를 읽어들이는 과정에서 발생하는 문제입니다. FFmpeg이 없거나 경로가 잘못 설정되어 있으면 이 호출이 실패하고, 결과적으로 사용자에게는 "업로드 실패"라는 증상으로 나타나게 됩니다.
2.2. 사용자 정의 노드 충돌: 상호 운용성 문제
ComfyUI의 모듈식 구조는 커뮤니티 개발을 촉진하지만, 동시에 예상치 못한 충돌의 원인이 되기도 합니다. 특히 영상 관련 기능이나 프런트엔드 확장 기능을 가진 사용자 정의 노드는 다른 노드나 ComfyUI의 핵심 기능과 충돌을 일으켜 Load Video 노드가 정상적으로 작동하지 않을 수 있습니다.10 실제 한 사용자 커뮤니티의 사례에서, 특정 사용자 정의 노드( ComfyUI-MimicMotion, ComfyUI_MiniCPM-V-2_6-int4, ComfyUI-DiffSynth-Studio 등)를 제거하자 Load Video 노드 문제가 해결된 사례가 보고되었습니다.12 진단 및 해결 방법 ComfyUI 매니저 활용: ComfyUI에 내장된 매니저 도구는 "Install Missing Nodes" 기능을 통해 누락된 노드를 자동으로 설치해 주며, 설치된 노드 간의 알려진 충돌을 표시해 줍니다.13 매니저에서 Load Video 노드와 충돌하는 노드가 있는지 확인하고, 해당 노드를 비활성화하거나 제거하는 것이 첫 번째 단계입니다. 이진 탐색(Binary Search) 방법: 충돌 노드를 찾기 위한 가장 효율적인 방법은 이진 탐색입니다.11 설치된 모든 사용자 정의 노드의 절반을 비활성화하고 ComfyUI를 재시작하여 문제가 해결되는지 확인합니다. 문제가 해결되면 비활성화한 그룹 내에 원인 노드가 있는 것이고, 해결되지 않으면 나머지 절반에 원인 노드가 있는 것입니다. 이 과정을 반복하여 충돌 노드를 하나씩 격리해낼 수 있습니다. 전체 노드 비활성화: python main.py --disable-all-custom-nodes 명령어를 사용하여 모든 사용자 정의 노드를 일시적으로 비활성화한 후 Load Video 노드가 정상적으로 작동하는지 테스트하는 것도 좋은 방법입니다.11 이러한 충돌은 단순히 노드가 누락되어 발생하는 문제 외에도, 특정 사용자 정의 노드가 ComfyUI의 프런트엔드 코드를 변경하거나, 동일한 라이브러리의 다른 버전을 사용하면서 발생하는 경우가 많습니다.11 이는 개발 속도가 빠른 ComfyUI 생태계에서 흔히 발생하는 문제입니다. 때때로 워크플로우 파일 자체의 포맷이 손상되거나( Zod Schema Validation Errors), 노드 유효성 검사 오류가 발생하기도 합니다.14 이는 ComfyUI가 워크플로우 파일을 정상적으로 해석하지 못했음을 의미합니다.
2.3. 영상 파일 자체의 문제: 파일 손상 및 비호환성
ComfyUI 환경이 완벽하게 설정되어 있다 하더라도, 원본 영상 파일에 문제가 있다면 처리가 불가능합니다. 영상 로드 실패는 파일이 손상되었거나, ComfyUI의 영상 처리 노드가 지원하지 않는 코덱이나 형식을 사용하고 있기 때문일 수 있습니다. 지원 형식 확인: ComfyUI Unified Media Suite 노드는 .mp4, .mov, .webp, .gif, .avi, .wmv 등 다양한 형식을 지원합니다.1 하지만 파일 확장자가 지원 목록에 있다고 해서 문제가 없는 것은 아닙니다. 파일 무결성 진단: 영상 파일의 손상 여부를 확인하는 가장 확실한 방법은 FFmpeg을 활용하는 것입니다. 터미널에 ffmpeg -v error -i file.mp4 -f null - 명령어를 입력하면 FFmpeg이 영상 파일을 읽으면서 발생하는 모든 오류를 로그로 출력해 줍니다.1 만약 "Invalid data found when processing input" 또는 "corrupt input packet"과 같은 메시지가 나타난다면, 파일에 손상이 있다는 의미입니다. 파일 복구 옵션: 손상된 파일은 종종 온라인 복구 도구(예: Stellar, Cleverfiles)를 사용하여 복원할 수 있습니다. 이러한 서비스는 H.264/H.265 코덱을 사용하는 .mp4 또는 .mov 파일의 손상된 헤더나 프레임을 복구하는 데 효과적입니다.18
이 단계에서는 1단계의 기본 점검으로 해결되지 않는, 더 복잡한 문제들을 다룹니다.
3.1. 오류 로그 분석의 중요성
문제가 지속될 경우, 사용자가 직면하는 가장 중요한 정보는 ComfyUI의 프런트엔드가 아닌, 터미널 또는 logs/CMFY.log 파일에 기록되는 상세 오류 메시지입니다.13 이 로그는 문제의 정확한 원인을 알려주는 결정적인 단서 역할을 합니다. 일반적인 오류 메시지 해독: Prompt execution failed: 이 메시지는 일반적인 오류로, ComfyUI 인터페이스의 Show report 버튼을 눌러 상세한 내용을 확인해야 합니다.10 Cannot execute because a node is missing the class_type property: 이 오류는 워크플로우에 정의된 특정 노드의 클래스 유형을 ComfyUI가 찾지 못했음을 의미합니다. 이는 주로 사용자 정의 노드 팩이 누락되었거나 손상되었을 때 발생합니다.20 mat1 and mat2 shapes cannot be multiplied: 이 오류는 PyTorch에서 발생하는 흔한 문제로, 주로 VRAM 부족이나 모델의 입력 차원(dimension) 불일치와 관련이 있습니다.21
3.2. 워크플로우 및 모델 경로 불일치
온라인에서 공유되는 ComfyUI 워크플로우(.json 또는 .png 파일)는 생성자의 로컬 시스템에 있는 모델 파일 경로를 그대로 포함하는 경우가 많습니다. 예를 들어, C:\Users\creator\ComfyUI\models\checkpoints\model.safetensors와 같은 경로는 다른 시스템에서는 유효하지 않습니다. 이 경우, ComfyUI는 Missing models 오류를 반환하며 작업을 실패시킵니다.10 해결책: 사용자는 워크플로우를 로드한 후, 체크포인트, LoRA, ControlNet, VAE 등 모든 모델 관련 노드를 수동으로 자신의 로컬 모델 경로에 있는 파일로 교체해야 합니다.13 이때 SD 1.5 모델은 SD 1.5 ControlNet과, SDXL 모델은 SDXL ControlNet과 같이 모델 유형을 올바르게 매칭하는 것이 중요합니다.
3.3. 시스템 환경 및 자원 제약
ComfyUI의 영상 처리 과정은 GPU 자원을 많이 소모합니다. 따라서 시스템의 물리적 한계로 인해 문제가 발생할 수 있습니다. "업로드" 실패처럼 보이지만 실제로는 메모리 부족으로 인해 프로그램이 중단되는 경우가 있습니다.10 VRAM 및 RAM: Out of memory 오류나 작업 중 시스템이 멈추는 현상은 GPU 메모리(VRAM) 또는 시스템 메모리(RAM)가 부족함을 의미합니다.10 이 경우, 영상의 해상도나 배치 크기(batch size)를 낮추거나, 불필요한 GPU 사용 프로그램을 종료하여 메모리를 확보해야 합니다. GPU 드라이버: 오래된 GPU 드라이버는 ComfyUI와 같은 최신 소프트웨어와의 호환성 문제를 일으켜 프로그램 충돌이나 오류를 유발할 수 있습니다.10 NVIDIA, AMD, Intel의 공식 웹사이트에서 최신 드라이버로 업데이트하는 것을 권장합니다.
이 섹션에서는 지금까지 논의된 모든 진단 및 해결책을 종합하여, 사용자가 실제 문제에 적용할 수 있는 명확한 가이드라인을 제공합니다.
4.1. 영상 문제 해결 순서도
영상 로드 또는 업로드 실패 │ ├─► 1. 영상이 VLC와 같은 미디어 플레이어에서 정상 재생되는가? │ ├─► 예: 2단계로 이동 │ └─► 아니오: 파일 손상 또는 비호환성 문제. FFmpeg으로 무결성 검사 및 온라인 복구 도구 사용. │ ├─► 2. ComfyUI에서 빨간색 노드 또는 "missing node" 오류가 나타나는가? │ ├─► 예: 사용자 정의 노드 충돌 문제. ComfyUI 매니저를 사용하여 충돌 노드 확인 또는 이진 탐색 진행. │ └─► 아니오: 3단계로 이동 │ ├─► 3. 터미널 로그에 "ffmpeg was not found" 또는 "Codec not found" 오류가 있는가? │ ├─► 예: FFmpeg 종속성 문제. FFmpeg을 올바르게 설치하고 환경 변수(PATH)에 추가. │ └─► 아니오: 4단계로 이동 │ ├─► 4. "Prompt execution failed" 오류가 나타나는가? │ └─► 예: 오류 로그를 자세히 분석. 워크플로우의 모델 경로를 수동으로 수정하거나, 시스템 자원(VRAM/RAM) 부족 여부 확인.
4.2. 종합 문제 해결 매트릭스
아래 표는 각 문제의 증상, 원인, 그리고 해결책을 요약하여 제공하는 참고 자료입니다.
문제 범주 구체적 증상 잠재적 원인 실행 가능한 해결책 참고 자료 종속성 실패 ffmpeg not found, Codec not found FFmpeg 누락 또는 PATH에 없음 FFmpeg을 설치하고 환경 변수에 추가 4 노드 충돌 Load Video 노드가 빨간색이거나 누락됨, 실행 실패 호환되지 않는 사용자 정의 노드 ComfyUI 매니저로 충돌 확인, 또는 이진 탐색으로 문제 노드 격리 11 파일 문제 미디어 플레이어에서 재생 불가, 끊김 현상 파일 손상, 비지원 형식/코덱 FFmpeg으로 무결성 검사, 온라인 복구 도구 사용 15 구성 문제 Prompt execution failed, Missing models 워크플로우 내 경로 불일치 워크플로우 내 모델 경로를 로컬 시스템에 맞게 수동 업데이트 10 시스템 한계 프로그램 충돌, 멈춤, Out of memory VRAM/RAM 부족 해상도/배치 크기 감소, 최적화 플래그 사용 10
4.3. 사전 예방적 유지보수
문제가 발생하기 전에 예방하는 것이 가장 효과적입니다. 다음 권장 사항들은 ComfyUI 환경을 안정적으로 유지하는 데 도움이 될 것입니다. 정기적인 업데이트: ComfyUI 코어와 사용자 정의 노드를 정기적으로 최신 버전으로 업데이트하는 습관을 들이는 것이 중요합니다. 격리된 환경 관리: 특정 워크플로우에만 필요한 복잡한 노드 팩은 별도의 ComfyUI 설치본이나 가상 환경에 구성하여, 코어 설치본과의 충돌 가능성을 줄일 수 있습니다. 커뮤니티 활용: 문제가 발생했을 때, CMFY.log 파일을 첨부하여 GitHub 이슈 페이지나 Discord 채널에 문의하기 전에, 먼저 기존 이슈나 토론을 검색하여 이미 알려진 문제인지 확인하는 것이 좋습니다.10
ComfyUI의 영상 처리 실패는 단순한 "업로드" 오류가 아니라, FFmpeg과 같은 필수 외부 종속성, 사용자 정의 노드 간의 복잡한 상호작용, 그리고 파일 자체의 속성 등 여러 요인이 복합적으로 작용한 결과입니다. 이 보고서에서 제시된 체계적인 진단 순서와 해결 매트릭스는 문제를 해결하기 위한 효과적인 로드맵을 제공합니다. 가장 중요한 것은 문제 해결을 위한 진단 도구로써 오류 로그와 터미널 출력을 활용하고, ComfyUI의 프런트엔드에서 나타나는 증상만으로 문제를 판단하지 않는 것입니다. 이 접근법은 사용자가 당면한 문제를 해결할 뿐만 아니라, 향후 유사한 기술적 난제에 직면했을 때도 자신감을 가지고 접근할 수 있는 능력을 키워줄 것입니다. 참고 자료 ComfyUI Unified Media Suite - ComfyUI Cloud, 8월 19, 2025에 액세스, https://comfy.icu/extension/fat-tire__comfyui-unified-media-suite VideoWriter Node Documentation (ComfyUI-Custom-Nodes) - ComfyAI.run, 8월 19, 2025에 액세스, https://comfyai.run/documentation/VideoWriter ComfyUI Node: Video Encoder (FFMPEG) - RunComfy, 8월 19, 2025에 액세스, https://www.runcomfy.com/comfyui-nodes/comfyui-dream-project/FFMPEG-Video-Encoder--Dream- python - ffmpeg was not found. How do i fix this? - Stack Overflow, 8월 19, 2025에 액세스, https://stackoverflow.com/questions/73335675/ffmpeg-was-not-found-how-do-i-fix-this How to Install FFmpeg on Windows - Adaptive Samples, 8월 19, 2025에 액세스, https://blog.gregzaal.com/how-to-install-ffmpeg-on-windows/ How to Install FFMPEG on Windows (2025) - YouTube, 8월 19, 2025에 액세스, https://www.youtube.com/watch?v=eRZRXpzZfM4 Installing FFmpeg | Audacity Support, 8월 19, 2025에 액세스, https://support.audacityteam.org/basics/installing-ffmpeg Install FFMpeg (optional) - CushyStudio, 8월 19, 2025에 액세스, https://docs.cushystudio.com/getting-started/installation/installing-modules/install-ffmpeg-optional Installing ffmpeg for CogVideoX on MacOS - Mac - ComfyUI, 8월 19, 2025에 액세스, https://forum.comfy.org/t/installing-ffmpeg-for-cogvideox-on-macos/947 How to Troubleshoot and Solve ComfyUI Issues, 8월 19, 2025에 액세스, https://docs.comfy.org/troubleshooting/overview How to Troubleshoot and Solve ComfyUI Issues, 8월 19, 2025에 액세스, https://docs.comfy.org/troubleshooting/custom-node-issues Load Video node broken for some reason : r/comfyui - Reddit, 8월 19, 2025에 액세스, https://www.reddit.com/r/comfyui/comments/1l8comj/load_video_node_broken_for_some_reason/ Troubleshooting workflows in ComfyUI, 8월 19, 2025에 액세스, https://learn.rundiffusion.com/troubleshooting-workflows-in-comfyui/ Fix These 2 Common ComfyUI Errors (Fast!) #comfyui #troubleshooting - YouTube, 8월 19, 2025에 액세스, https://www.youtube.com/watch?v=R0rH_Y_NB-E comfy.icu, 8월 19, 2025에 액세스, https://comfy.icu/extension/fat-tire__comfyui-unified-media-suite#:~:text=Load%20single%20or%20multi%2Dimage,audio%20and%20video%20to%20ComfyUI. How to QUICKLY batch scan video files to check for integrity (corrupt / valid) - Stack Overflow, 8월 19, 2025에 액세스, https://stackoverflow.com/questions/75689185/how-to-quickly-batch-scan-video-files-to-check-for-integrity-corrupt-valid How to Check If a Video File Is Corrupted [Using FFmpeg] - EaseUS Software, 8월 19, 2025에 액세스, https://www.easeus.com/questions/recovery/how-to-check-if-a-video-file-is-corrupted.html 100% Free Video Repair Tool Online: Fix Corrupted MP4, MOV File - Clever Online Video Repair, 8월 19, 2025에 액세스, https://repair.cleverfiles.com/ Free Video Repair Online: Fix Corrupt MP4, MOV, AVI Videos, 8월 19, 2025에 액세스, https://repair.stellarinfo.com/ Video not working - Custom Nodes - ComfyUI, 8월 19, 2025에 액세스, https://forum.comfy.org/t/video-not-working/1558 comfyanonymous/ComfyUI - GitHub, 8월 19, 2025에 액세스, https://github.com/comfyanonymous/ComfyUI/issues Issues · neverbiasu/Awesome-ComfyUI-Video - GitHub, 8월 19, 2025에 액세스, https://github.com/neverbiasu/Awesome-ComfyUI-Video/issues