知仓学习社知仓学习社
WebSocket 断开／Reconnecting，进度条卡在 0% 但后端其实已经出图 / 全站资源搜索
搜索 更新 2026-10-02
报错 083 前端界面、浏览器与工作流加载 有来源可查

WebSocket 断开／Reconnecting，进度条卡在 0% 但后端其实已经出图

报错原文（原样） 
TypeError: Failed to fetch
Failed to fetch server logs
检索关键词 Reconnecting、WebSocket connection failed、progress stuck 0%、ws://、/ws、进度条不动、卡在 0%
先看这一句 进度条长时间停在 0% 或某个百分比不动，界面反复显示 Reconnecting，同时后端终端能看到工作流其实还在跑甚至已经出图；也可能界面进度正常但图一直不出现。
适用版本 全版本通用 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

  • 执行过程中后端进程崩溃或被系统杀掉，前端与 /ws 的连接随之断开
  • 前端连的端口与实际服务端口不一致（例如把 8000 与 8188 混用）
  • 通过反向代理/隧道访问时 WebSocket 升级被代理拦掉
  • 浏览器侧网络策略或扩展阻断长连接

根因

  • 进度显示完全依赖 WebSocket。官方文档 Server Overview 说明服务端通过 socket 消息把执行状态推给客户端，由前端注册的 socket 事件监听器处理；这条链路一断，界面就再也收不到进度与结果，只能显示 Reconnecting
  • WebSocket 与 HTTP 共用同一个服务，端口或监听地址不一致时，首页可能还能打开（走的是 HTTP），但 /ws 升级失败
  • 后端崩溃导致的断开。christian-byrne 在 ComfyUI#9171 的处置思路是要求上传完整日志与出错状态的工作流截图，以确认是哪个节点导致失败——即先定位崩溃点，而不是先猜网络问题

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 先在浏览器 F12 → Network 里看 /ws 这条连接的状态
    筛选 WS 类型，看 /ws 是否成功从 101 Switching Protocols 建立了长连接、以及是不是中途变成 closed。同时看 Console 的断开时间点，与后端终端里 traceback 的时间戳对齐：后端先有 traceback 就是后端问题，后端无任何输出就是链路/代理问题。
  2. 直接绕过界面用 HTTP 查真实状态，判断后端是否还在跑
    官方文档 comms_routes 说明 /prompt 提交后会返回 prompt_id 与队列位置，历史与队列都有对应接口。用 curl 查队列与历史，如果任务已经完成、历史里有输出，说明后端没问题、丢的只是进度推送这条链路，不必重启任务。
    curl -s http://127.0.0.1:8188/queue
    curl -s http://127.0.0.1:8188/history
    curl -s http://127.0.0.1:8188/system_stats
  3. 按自定义节点方向定位把后端搞崩的节点
    后端运行中崩溃最常见的原因仍是某个自定义节点。用官方文档给出的第一步禁用全部自定义节点启动，再二分放回，定位到具体节点后更新或移除它。修改启动参数后必须重启整个 ComfyUI 进程，仅刷新网页无效。
    python main.py --disable-all-custom-nodes
  4. 把端口、监听地址与代理统一起来
    确认启动命令里的 --port 与浏览器地址栏端口一致；远程/容器场景用 --listen 0.0.0.0 暴露服务。若前面挂了反向代理或隧道，需要自行确保该代理转发 WebSocket 升级请求，官方文档只保证 ComfyUI 自身在默认端口上同时提供 HTTP 与 /ws。
    python main.py --listen 0.0.0.0 --port 8188
    curl -i -N -H "Connection: Upgrade" -H "Upgrade: websocket" http://127.0.0.1:8188/ws

验证是否修好

F12 → Network 中 /ws 保持 101 长连接，刷新页面后不再出现 Reconnecting；提交一个工作流能实时看到进度百分比变化，执行完成后结果立即出现在界面。

补充说明

ComfyUI#9171 采集时仍为 open 且无维护者最终结论，本条的现象描述取自该 issue 正文原文（"After reaching 36%, it starts showing 'Reconnecting' and then displays a TypeError: Failed to fetch"），根因与解法以官方 Server Overview / comms_routes 文档为准，未采用该 issue 中未经确认的社区猜测。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [192] （官方 issue）　TypeError: Failed to fetch　https://github.com/Comfy-Org/ComfyUI/issues/9171
  2. [193] （官方文档）　Server Overview　https://docs.comfy.org/development/comfyui-server/comms_overview
  3. [200] （官方文档）　ComfyUI Server Routes (HTTP and WebSocket API)　https://docs.comfy.org/development/comfyui-server/comms_routes

这条报错要用到的东西

按本条报错所属的类别（前端界面、浏览器与工作流加载）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

常用节点速查包常用节点参数小抄 / 常见连法示意图 待挂载
工作流换一条已知结构完整的工作流对照排查 板块

同一类别的其他条目

【078】打开 127.0.0.1:8188 只有空白页或一直转圈，界面加载不出来 有来源 【079】工作流所有节点变红、提示缺少节点或 Cannot find node，无法执行 有来源 【080】新版前端与旧工作流不兼容：旧工作流节点错位、widget 丢失或值变成 undefined 有来源 【081】浏览器控制台报 Failed to load resource: ERR_CONNECTION_REFUSED，页面打不开或功能全失效 有来源 【082】出图成功但看不到图：预览 404、保存的图片找不到 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库