ComfyUI "Failed to Fetch"：先判断是哪条连接失败
ComfyUI 显示 Failed to Fetch 只说明浏览器没有收到可用响应。修改安装前，先区分失败来自后端、Manager、Registry、WebSocket、工作流草稿还是代理。
Failed to fetch 本身不能说明 ComfyUI 的真正问题。
它只表示浏览器发出了请求，但没有收到可用响应。失败请求可能属于 ComfyUI 本体、ComfyUI Manager、ComfyRegistry、工作流草稿保存、server logs 或 WebSocket 连接。
不要立刻重装 ComfyUI。
先判断 界面原本想 fetch 的是什么。
30 秒检查
使用 ComfyUI 启动日志里显示的地址。默认本地安装通常是 http://127.0.0.1:8188。先确认后端仍在运行，再在新标签页打开同一个地址，然后根据触发 Failed to fetch 的操作选择对应分支。
先选对分支
| 失败的是什么 | 最可能的层级 | 下一步 |
|---|---|---|
| 整个 ComfyUI 页面都不响应 | 后端停止，或地址变了 | 先确认后端是否还活着 |
| 只有 server logs 无法加载 | server-log API、前后端版本不匹配，或本地请求被拦截 | Failed to Fetch Server Logs |
| Manager 无法加载 custom-node list | Manager、Registry、GitHub、缓存、代理或 DNS | Failed to Get Custom Node List |
页面反复显示 Reconnecting... | WebSocket 或后端连接 | ComfyUI Reconnecting Error |
| 工作流草稿保存失败 | draft-save 请求或后端连接 | Failed to Save Workflow Draft |
| 只在 VPN、代理、隧道或公司网络下失败 | 请求被拦截或端点被阻断 | 看下面的代理和防火墙分支 |
| ComfyUI Desktop 能打开，但 UI 连不上后端 | Desktop 管理的后端或端口不一致 | 看下面的 Desktop 分支 |
先确认后端是否还活着
查看启动 ComfyUI 的终端、PowerShell、命令行窗口、launcher 日志或 Desktop 日志。
健康的后端通常会继续运行，并显示前端应该访问的地址。
例如：
To see the GUI go to: http://127.0.0.1:8188使用 你自己日志里的 host 和 port。不要假设所有安装都使用 8188 端口。
后端可能还在运行，如果
- 终端没有关闭。
- 日志末尾没有 traceback。
- 打开日志里的地址可以加载 ComfyUI。
- Queue 和 History 请求仍然正常。
- 只有一个 Manager 或前端功能失败。
这种情况下，问题通常局限在某个请求、浏览器路径、网络层或扩展。
后端可能已经停止，如果
- 终端关闭了。
- fetch error 之前出现了 Python traceback。
- 原来的地址打不开。
- 界面所有部分同时失败。
- 重启后使用了不同端口。
浏览器里的 Failed to fetch 不能解释后端为什么停止。请读取最后的终端错误；如果服务器无法启动，用 ComfyUI Startup Failed 排查。
如果只有 server logs 无法加载
如果 ComfyUI 主界面还能用，但 server-log 面板显示 Failed to fetch，不要把它当作完整的 ComfyUI 崩溃。
失败可能仅限于：
- server-log endpoint；
- 前端和后端版本不匹配；
- 过期的浏览器 bundle；
- 没有转发该 endpoint 的反向代理；
- Desktop 或打包环境使用了不同的后端 route。
继续看 ComfyUI "Failed to Fetch Server Logs"。这个父页只负责分流，不重复 endpoint 专项步骤。
如果 Manager 无法加载 custom-node list
Manager 失败不等于 ComfyUI 本体坏了。
ComfyUI Manager 可能需要访问：
- ComfyRegistry；
- GitHub；
- raw GitHub content；
- 缓存的 node list；
- Manager 专用 API endpoints。
先检查普通 ComfyUI 生成是否仍然正常。
如果只有 Manager 显示：
Failed to get custom node list或：
Failed to find the following ComfyRegistry list继续看 ComfyUI-Manager "Failed to Get Custom Node List"。
在确认 Manager 请求前，不要重装所有 custom nodes。
如果界面一直 Reconnecting
Reconnecting 通常表示前端失去了与 ComfyUI 后端的实时连接。
这和一个可选 Manager 请求失败不是一回事。
可能的层级包括：
- ComfyUI 进程停止；
- 后端正在重启；
- WebSocket 连接被阻止；
- 反向代理没有转发 WebSocket 流量；
- 浏览器仍在使用旧端口；
- 电脑休眠或网络变化。
继续看 ComfyUI Reconnecting Error。
如果页面能重新连接且生成仍然正常，不要做完整依赖重装。
如果保存工作流草稿失败
工作流草稿失败更紧急，因为当前 graph 可能只存在于打开的浏览器标签页里。
最安全的第一步是：刷新或关闭标签页前，先使用当前可用的 Save 或 Export 选项。
这个错误表示自动 draft-save 请求失败了，不一定表示工作流已经消失。
在保存或导出前，避免：
- 刷新页面；
- 关闭浏览器标签页；
- 清除浏览器站点数据；
- 未保存可见 graph 就重启 ComfyUI。
继续看 ComfyUI "Failed to Save Workflow Draft"。
如果只是普通工作流备份和恢复，而不是正在出错，暂时使用同一页面里的工作流保存章节。
如果涉及 VPN、代理、防火墙或公司网络
某个请求可能能到达 ComfyUI 主页面，但另一个 endpoint 被阻断。
常见场景：
- 通过反向代理访问 ComfyUI；
- 浏览器代理扩展已开启；
- VPN 改变了本地路由；
- 安全软件过滤 localhost 流量；
- 公司网络阻断 GitHub 或 Registry 请求；
- HTTP 和 HTTPS 混用；
- WebSocket 转发缺失。
不要第一步就禁用所有安全控制。
先比较：
- 临时绕过 VPN 或代理后的同一操作。
- ComfyUI 主页面和具体失败功能。
- 本地访问和反向代理访问。
- 普通浏览器窗口和无扩展的隐私窗口。
如果只在绕过某个网络层后恢复，请检查该层规则，而不是修改 ComfyUI Python 环境。
如果你使用 ComfyUI Desktop
ComfyUI Desktop 管理启动环境的方式不同于 manual 或 Portable 安装。
不要假设：
- 后端一定使用默认端口；
- Python 环境等同于系统 Python；
- Portable 修复命令适用于 Desktop；
- 重启后浏览器地址保持不变。
在 Desktop app 或日志里确认：
- 当前 backend address；
- startup failure messages；
- frontend/backend version information；
- backend 是否重启；
- extension loading errors。
Desktop 管理路径和恢复操作可能随版本变化。应用 manual 或 Portable 命令前，请先查看当前 app UI 或官方 Desktop 文档。
用浏览器开发者工具定位失败请求
如果提示仍然太模糊，浏览器可以显示具体失败的请求。
在 Chromium 系浏览器中：
- 打开 Developer Tools。
- 选择 Network。
- 重复触发
Failed to fetch的操作。 - 找到失败的 request。
- 记录 request name、URL、status 和 error。
| 你看到的内容 | 可能说明 |
|---|---|
| 请求指向 Manager 或 Registry route | Manager 或外部服务问题 |
| 请求指向 server logs | server-log endpoint 问题 |
| WebSocket connection 关闭 | 后端或代理连接问题 |
| 请求使用了错误端口 | 前端地址过期或后端重启 |
| request 被 client blocked | 浏览器扩展或过滤软件 |
| connection refused | 该地址没有 backend 在监听 |
| 主页面可用但某个 endpoint 报错 | 特定功能的后端失败 |
分享 Network 面板截图时，不要公开 cookies、authorization headers、私有 workflow data、本地用户名或 API keys。
不要先做这些
避免把这些当万能修复：
- 重装 ComfyUI；
- 删除所有 custom nodes；
- 升级所有 Python packages；
- 在系统 Python 里运行
pip install； - 导出 workflow 前清除浏览器数据；
- 永久关闭防火墙；
- 因为一个 HTTP 请求失败就改 CUDA 或 PyTorch；
- 认为所有安装都必须使用
8188端口。
这些操作可能在没找到失败请求前制造第二个问题。
如何确认已经修好
重复最初触发 Failed to fetch 的同一个动作。
成功修复应满足对应条件：
- 同一个 panel 现在能加载；
- Manager 能取回列表；
- 页面不再 reconnecting；
- workflow draft 能保存；
- failed request 返回可用响应；
- ComfyUI 在启动日志显示的地址上持续可用。
如果原始失败涉及具体的 Manager、log、draft 或 WebSocket request，不要只用“页面打开过一次”作为验收。
Wonderful Launcher 如何帮忙
Wonderful Launcher 最适合在你知道失败层级之后使用。它可以帮助你更有序地管理 ComfyUI 环境、模型文件夹和 custom node setup，避免把每个连接提示都当作完整重装。
如果失败请求指向缺失模型、损坏 custom nodes 或本地环境损坏，先使用上面的具体指南，再在需要更清晰地管理恢复工作时 下载 Wonderful Launcher。
相关 ComfyUI 连接错误
- Failed to Fetch Server Logs
- Failed to Get Custom Node List
- ComfyUI Reconnecting Error
- Failed to Save Workflow Draft
- ComfyUI Startup Failed
- ComfyUI Workflow Has Missing Nodes
来源参考
先按上面的步驟定位根因。还卡住时，可以下载 Wonderful Launcher 检查目前机器；启动器原生修复、任务日誌和執行階段检查会集中在一起。credits 只用於图片生成和按量工具。
下载 Wonderful Launcher查看 credits 方案这篇文件解決了你的問题嗎？
你的回饋会帮助我们優先補強真實 ComfyUI 排障文件。