LogoWonderful Launcher
  • 首页
  • 定价
  • 文档
  • 下载
故障排除决策树启动失败修复便携版依赖ComfyUI 常见问题与快速修复反复重连无法获取日志CUDA 显存不足资源包下载失败Top 10 错误
故障排除

ComfyUI 一直 Reconnecting:卡住界面怎么修

Partially verifiedLow riskTested on Windows 10, Windows 11 | portable | Python 3.11+ | CUDA 12.x | Torch 2.x | ComfyUI reconnecting 循环、本地 websocket 路径和 custom node 排查Last verified 2026-06-04Estimated time 5-20 分钟

修复 ComfyUI 页面一直 Reconnecting 的问题,重点检查后端崩溃、127.0.0.1、本地 websocket、custom nodes、VPN、代理和防火墙。

如果这个问题已经碰到你真实在用的 ComfyUI 环境,先用 Wonderful Launcher 接管和检查当前机器,再配合文档决定怎么修。

下载 Wonderful Launcher

如果 ComfyUI 页面一直停在 "Reconnecting...",说明浏览器和 ComfyUI 服务之间的实时连接断掉了。第一步先看后端终端,不要先重装。

通常只有两类根因:

  • ComfyUI 后端已经崩了、卡死了,或者自动重启了
  • 浏览器没法继续保持 websocket 连接

最快的修法不是重装,而是先确认服务是不是还活着,再区分问题来自 custom nodes、更新后的依赖冲突,还是浏览器 / 网络路径本身。

30 秒判断

先打开 ComfyUI 的终端。如果终端已经关闭或有 traceback,就先修后端错误。若终端还活着,先直接测试 http://127.0.0.1:8188,再排 VPN、代理、防火墙和浏览器 websocket 问题。

快速答案

如果你搜的是 ComfyUI reconnecting error,先做这三步:

  1. 看 ComfyUI 终端。如果已经关闭或出现 traceback,按后端崩溃处理。
  2. 先访问 http://127.0.0.1:8188,不要先测局域网地址、反向代理或远程地址。
  3. 如果是装节点或更新节点后开始 Reconnecting,先禁用 custom nodes 重启一次。

如果终端已经没了,或者你连真实日志都看不到,先看 ComfyUI “failed to fetch server logs” 修复。如果问题是在插件改动后出现,也一起看 ComfyUI Dependency Conflicts 和 ComfyUI Manager Failed to Get Custom Node List。

快速判断

你看到什么最可能的原因第一检查项
浏览器一直 Reconnecting,终端已经关闭后端服务崩溃回去读终端日志
刷新后短暂恢复,再继续断websocket 前端链路不稳定检查浏览器 Console 和扩展
安装或更新节点后开始断custom node 或前端扩展冲突先禁用 custom nodes
一按 Queue 或运行中断开GPU、显存或执行阶段崩溃看终端第一条报错
只在局域网、代理或远程方式下断网络路径、防火墙、绑定地址问题先用 localhost 测
同时出现 failed to fetch server logs日志接口在断连后也失败了先看终端,再看 server logs 页面

第 1 步:确认服务还活着

先看 ComfyUI 终端窗口。如果终端已经关闭、卡死,或者里面有 traceback,就不要把 Reconnecting 当成浏览器问题。

如果终端还在,直接打开:

http://127.0.0.1:8188

先用 127.0.0.1,不要先测局域网 IP、代理域名或远程地址。这样可以把“本机 ComfyUI 问题”和“网络访问路径问题”分开。

第 2 步:找第一条真正的错误

不要只看终端最后一行,要往上翻,找第一条真正的报错:

Traceback (most recent call last):
ModuleNotFoundError
ImportError
CUDA out of memory
RuntimeError
ConnectionResetError

很多情况下,Reconnecting 只是二级症状。比如某个插件导入失败,先把后端打崩了,浏览器才开始显示 Reconnecting。

第 3 步:先禁用 custom nodes 试一次

custom nodes 是最常见的诱因之一。

手动安装:

python main.py --disable-all-custom-nodes

Windows 便携版就在启动命令后面加:

--disable-all-custom-nodes

如果这样就恢复正常,核心环境大概率还在,问题更可能是某个节点、某个前端扩展,或者它带进来的依赖。

第 4 步:排浏览器和 websocket

如果后端其实还活着,但浏览器一直重连,就查浏览器这一侧:

  • Ctrl+F5 强刷
  • 换 Chrome 或 Edge,并临时关闭扩展
  • 打开 DevTools 看 Console 和 Network
  • 暂时关闭 VPN 或代理
  • 优先访问 http://127.0.0.1:8188

如果只在某个浏览器配置文件里出问题,说明后端可能没坏,断的是前端连接路径。

第 5 步:排端口、防火墙和运行时崩溃

如果怀疑端口冲突或绑定错误,在 Windows 上查:

netstat -ano | findstr :8188

如果一按 Queue 才掉线,还要查:

  • CUDA out of memory
  • GPU 驱动 reset
  • 模型 / 工作流不兼容
  • custom node 执行阶段崩溃

这时先试小工作流、降低分辨率、减小 batch,必要时加 --lowvram。

相关页面

  • ComfyUI “failed to fetch server logs” 修复
  • ComfyUI Dependency Conflicts
  • ComfyUI Manager Failed to Get Custom Node List
  • How to Fix ComfyUI Plugin Import Failed Errors
  • Python Out of Memory in ComfyUI

如果这个问题已经碰到你真实在用的 ComfyUI 环境,先用 Wonderful Launcher 接管和检查当前机器,再配合文档决定怎么修。

下载 Wonderful Launcher
相关指南:Fix failed server log fetchesDiagnose startup failuresRepair dependency conflicts

如果这个问题已经碰到你真实在用的 ComfyUI 环境,先用 Wonderful Launcher 接管和检查当前机器,再配合文档决定怎么修。

下载 Wonderful Launcher

Did this fix your issue?

Your answer helps prioritize verified ComfyUI repairs.

ComfyUI 常见问题与快速修复

快速处理 ComfyUI 常见问题,包括 CUDA 错误、红节点、缺模型、prompt has no outputs、速度很慢、反复 reconnecting 等。

无法获取日志

修复 ComfyUI failed to fetch server logs 错误,先检查后端终端、127.0.0.1、本地浏览器请求路径、代理或防火墙,以及 custom nodes。

目录

快速答案
快速判断
第 1 步:确认服务还活着
第 2 步:找第一条真正的错误
第 3 步:先禁用 custom nodes 试一次
第 4 步:排浏览器和 websocket
第 5 步:排端口、防火墙和运行时崩溃
相关页面