ComfyUI 재연결 오류: 화면 멈춤 및 Reconnecting 상태 복구
ComfyUI 브라우저 화면이 "재연결 중(Reconnecting...)" 상태에서 응답하지 않는 오류 해결법. 서버 크래시, Websocket 연결 유실, 프록시 충돌 분석.
30초 판단 분기
가장 먼저 ComfyUI 서버가 실행 중인 까만 터미널 콘솔창을 확인하세요. 터미널 내에 에러 예외 정보(Traceback)가 출력되어 멈춰 있거나 창 자체가 강제 종료되었다면, 이는 브라우저 문제가 아닌 백엔드 Python 서버 자체의 크래시입니다. 콘솔창이 이상 없이 동작 중이라면 VPN, 프록시 가속기, 윈도우 방화벽, 혹은 브라우저 플러그인의 통신 방해를 검사해야 합니다.
ComfyUI 웹 브라우저 화면이 "Reconnecting... (재연결 중...)" 상태에서 멈춰 있다면, 브라우저 클라이언트와 ComfyUI 백엔드 서버 간의 실시간 통신망(Websocket)이 끊어진 것입니다. 무작정 전체 프로그램을 재설치하지 말고, 백엔드 터미널 콘솔창의 출력 로그부터 차근차근 점검하십시오.
화면에 **Failed to fetch**만 보이고 Reconnecting...인지 명확하지 않다면 ComfyUI "Failed to Fetch"에서 실패한 요청을 먼저 확인하세요.
보통 아래의 두 범주 중 하나에 해당합니다.
- ComfyUI 백엔드 파이썬 프로세스가 크래시되어 작동이 멈춤.
- 파이썬 프로세스는 잘 켜져 있으나, 네트워크망 필터링 등으로 인해 웹소켓 실시간 연결 수립에 실패함.
신속 진단 가이드
| 발생 현상 | 예상 원인 | 우선 점검 사항 |
|---|---|---|
| 브라우저 화면에 "Reconnecting..."이 뜨고 터미널 창은 꺼져 있음 | 백엔드 서버 크래시 종료 | 서버 시작 로그의 마지막 Traceback 확인 |
| 새로고침(F5)을 누르면 일시적으로 재연결됨 | 프론트엔드 웹소켓 세션 유지 차단 | 브라우저 확장 프로그램 및 캐시 비우기 |
| 특정 노드를 새로 설치/업데이트한 뒤 발생함 | 노드 플러그인 버전 충돌 및 프론트엔드 확장 에러 | --disable-all-custom-nodes 옵션 인가 후 부팅 테스트 |
| 렌더링(Queue)을 돌리는 도중에 끊김 | 그래픽카드 메모리 초과(OOM) 및 드라이버 리셋 | 터미널 콘솔창 내부의 최초 에러 문자열 조회 |
| 외부 네트워크(원격, 공유기 내부망) 연결 시에만 발생 | 방화벽 차단, 프록시 터널링 장애, 주소 바인딩 오류 | 로컬 127.0.0.1로 직접 접속 테스트 |
해결 조치 단계
1단계: 서버 생존 및 로컬 호스트 테스트
ComfyUI 실행 콘솔창을 확인하십시오. 창이 열려 있다면, 외부 통신망 설정 간섭을 방지하기 위해 로컬 루프백 주소로 직접 접속해 봅니다.
http://127.0.0.1:8188공유기 IP나 도메인 주소로 접속하기 전, 반드시 본인의 127.0.0.1 주소 접속성부터 확인해야 네트워크 설정 오류와 ComfyUI 핵심 구동 오류를 분리할 수 있습니다.
2단계: 최초 에러 로그 추적
오류 로그 아래쪽의 꼬리 부분만 보지 마시고, 콘솔창을 위로 스크롤하여 기동 이후 기록된 **최초의 붉은색 에러 덩어리(Traceback)**를 읽으세요. 모듈 누락이나 CUDA 런타임 오류가 시작 지점에 박혀 있다면 그것이 크래시의 근본적인 원인입니다.
3단계: 커스텀 노드 비활성화 테스트
다양한 수의 노드를 쓰다 보면 프론트엔드 확장 모듈이 꼬여 연결망 오류가 나는 경우가 잦습니다. 임시로 아래 옵션을 붙여 ComfyUI 서버를 시작하십시오.
python main.py --disable-all-custom-nodes포터블 버전인 경우:
자주 쓰는 실행 배치파일(bat)을 복사한 다음, 편집기로 열어 뒤에 --disable-all-custom-nodes를 한 칸 띄우고 적어 실행합니다.
만약 이 조치로 웹UI가 쾌적하게 켜지고 연결이 유지된다면, ComfyUI 런타임 자체는 멀쩡한 상태이며 최근 도입한 특정 커스텀 노드가 실시간 통신이나 화면 렌더링 규격을 깨고 있는 것입니다. 문제 노드를 격리해 제거하세요.
4단계: 브라우저 캐시 및 프록시 정리
파이썬 서버는 정상인데 브라우저 접속만 주기적으로 끊긴다면 아래를 실행하세요.
Ctrl + F5를 눌러 캐시 강제 새로고침- 크롬/엣지 브라우저의 시크렛 모드(비밀 모드)로 접근
- VPN, 가속기, 백신 실시간 보호 웹 필터링 임시 정지
5단계: 로컬 포트 점유 해소
포트 8188이 켜기 전에 다른 웹서버나 백그라운드 프로세스에 선점당하면 연결이 안 되거나 꼬이게 됩니다.
명령 프롬프트에서 확인해 점유 중인 PID를 죽이거나,
netstat -ano | findstr :8188아래와 같이 다른 포트로 임시 변경하여 구동한 후 확인합니다.
python main.py --port 8189그 후 http://127.0.0.1:8189 주소로 우회 접근해 봅니다.
6단계: 그래픽 메모리(VRAM) 한계 해소
렌더링 실행 대기열에 진입한 즉시 튕겨서 재연결이 뜨는 현상은 GPU가 버티지 못하고 연산 드라이버 레벨에서 프로세스를 강제 리셋시켰기 때문입니다.
- 생성 해상도 축소
- 배치 사이즈 축소
- 실행bat 옵션에
--lowvram인가하여 메모리 분할 적재 - 백그라운드에 구동 중인 게임 등 GPU 점유 앱 종료
관련 가이드
실제 ComfyUI 환경에서 생긴 문제라면 먼저 무료로 Wonderful Launcher 로 현재 머신을 확인하세요. 런처 안의 복구 흐름, 작업 로그, 실행 환경 점검을 한곳에서 볼 수 있습니다. 크레딧은 이미지 생성과 사용량 기반 도구용입니다.
Wonderful Launcher 다운로드크레딧 요금제 보기Did this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.