ComfyUI 重新连接错误：修复卡住的界面

如果你搜索的是 comfyui reconnecting error，或者界面卡在 Reconnecting...，本页面针对的是实时连接循环中断的问题，而非 Manager 注册表失败或插件 IMPORT FAILED 报错。

如果 ComfyUI 卡在 "正在重新连接..."，说明浏览器已与 ComfyUI 服务器失去实时连接。请先检查后端终端，而不是急着重装。

如果界面只显示 Failed to fetch，并不明确是 Reconnecting...，请先看 ComfyUI "Failed to Fetch" 找出失败请求。

简单来说，通常发生了以下两种情况之一：

• ComfyUI 后端崩溃、冻结或重启
• 浏览器无法维持 websocket 连接

最快的解决办法不是重装，而是确认服务器是否仍在运行，然后逐步排查问题是来自自定义节点、错误更新，还是浏览器或网络阻断。

快速解答

如果你搜索的是 "ComfyUI 重新连接错误"，请先做这三步检查：

1. 查看 ComfyUI 终端。如果已关闭或显示报错堆栈，将其视为后端崩溃处理。
2. 在测试局域网 IP、反向代理或远程 URL 之前，先打开 http://127.0.0.1:8188。
3. 如果重新连接问题是在安装或更新节点后开始的，先禁用自定义节点重启一次。

如果终端已消失或无法清晰阅读日志，请从 ComfyUI 无法获取服务器日志 开始排查。如果问题在插件操作后立即出现，还需检查 ComfyUI 依赖冲突。如果 Manager 明确提示 failed to get custom node list，请使用 ComfyUI 无法获取自定义节点列表，而不是本重新连接页面。

快速诊断

第一步：检查服务器是否仍在运行

打开 ComfyUI 终端窗口。如果终端已消失、冻结或显示报错堆栈，将重新连接提示视为服务器端故障处理。

如果终端仍在运行，尝试打开：

http://127.0.0.1:8188

在测试局域网 IP、反向代理或远程地址之前，先用 127.0.0.1。这样可以将本地 ComfyUI 问题与网络访问问题区分开来。

如果你修改了端口，请使用对应端口代替 8188。

第二步：阅读终端中的第一个真实错误

不要从最后一行开始看。向上滚动，找到第一个严重错误：

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

第一个错误之后的所有内容可能都是次生症状。例如，插件导入失败可能导致服务器崩溃，而浏览器只显示可见的重新连接状态。

ComfyUI 官方故障排查指南也建议在报告 bug 之前收集终端日志、浏览器控制台错误、已安装的自定义节点以及复现步骤。

第三步：在禁用自定义节点的情况下测试

自定义节点是 ComfyUI 在更新或安装插件后开始重新连接的常见原因。

手动安装时，运行：

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

对于 Windows 便携版，复制一份启动批处理文件并添加：

--disable-all-custom-nodes

如果禁用自定义节点后 ComfyUI 可以正常运行，说明核心安装可能没有问题。问题很可能是某个自定义节点、某个前端扩展，或由自定义节点安装的某个依赖项。

然后缩小范围：

1. 重新启用一半自定义节点。
2. 重启 ComfyUI。
3. 如果重新连接问题再次出现，问题节点在这一半中。
4. 重复操作直到找到有问题的插件。

对于更深层的插件故障，使用 如何修复 ComfyUI 插件导入失败错误。

如果 ComfyUI Manager 在重新连接循环开始之前就停止加载节点元数据或插件列表，请检查 ComfyUI 无法获取自定义节点列表。

第四步：同时更新前端和依赖项

部分重新连接问题发生在只更新了部分组件之后。

如果使用 git pull 更新 ComfyUI，也要在同一环境中更新依赖项。

如果使用便携版，请使用捆绑的 Python，而不是随机的系统 Python。一个常见错误是将包安装到错误的环境中，然后疑惑为什么 ComfyUI 仍然失败。

对于与更新相关的依赖问题，请参阅 ComfyUI 依赖冲突。

第五步：检查浏览器和 Websocket 问题

如果服务器正在运行，但浏览器持续重新连接，请检查浏览器端。

尝试：

• 使用 Ctrl+F5 强制刷新页面
• 使用禁用扩展程序的 Chrome 或 Edge
• 打开开发者工具，检查控制台和网络选项卡
• 使用 http://127.0.0.1:8188 而非局域网或代理地址
• 暂时禁用 VPN、代理或激进的防病毒网络过滤

ComfyUI 依赖浏览器到服务器的实时连接。即使 Python 服务器运行正常，浏览器扩展程序、代理工具、远程隧道和企业安全软件也可能中断该连接。

如果重新连接只发生在某个浏览器配置文件中，这是后端可能正常而问题出在前端路径而非工作流上的有力信号。

第六步：检查端口和防火墙问题

如果其他应用程序占用了 8188 端口，ComfyUI 可能无法正确绑定，或者你可能连接到了错误的进程。

在 Windows 上检查端口：

netstat -ano | findstr :8188

如果端口被占用，在另一个端口上启动 ComfyUI：

python main.py --port 8189

然后打开：

http://127.0.0.1:8189

如果从其他设备访问 ComfyUI，请确保防火墙允许该端口，并且 ComfyUI 实际上在正确的网络接口上监听。

第七步：检查生成过程中的 GPU 或内存崩溃

如果重新连接只在按下"队列"按钮后或工作流运行期间出现，请检查运行时崩溃：

• CUDA 内存不足
• 驱动程序重置
• 模型架构不匹配
• 自定义节点执行错误
• Python 进程被操作系统终止

尝试使用更小的工作流：

• 降低分辨率
• 减小批处理大小
• 关闭其他占用 GPU 的应用程序
• 使用默认工作流进行测试
• 如果 GPU 显存紧张，使用 --lowvram 运行

如果终端显示 CUDA out of memory，请参阅 ComfyUI 中的 Python 内存不足 和 GPU 兼容性。

按触发条件选择最佳下一步

什么时候重装是错误的第一步

如果你已经拥有以下内容，重装可能掩盖真正的原因并浪费时间：

• 已下载的模型
• 自定义节点
• 可用的工作流
• 项目专属设置
• 客户端或生产资产

只有在确认问题来自核心 ComfyUI、某个自定义节点、依赖冲突还是网络或浏览器问题之后，再考虑重装。

Wonderful Launcher 如何提供帮助

Wonderful Launcher 专为 ComfyUI 环境不再是干净安装的阶段而设计：

• 插件更改了依赖项
• 启动日志包含多个失败
• 自定义节点更新破坏了前端
• 需要保留模型和工作流
• 希望有比随机执行 shell 命令更清晰的恢复路径

如果自定义节点或依赖项工作后重新连接问题持续出现，在清空环境之前先尝试 Wonderful Launcher。

寻求帮助时需要提供的信息

请提供以下详细信息：

常见问题

为什么 ComfyUI 一直显示 正在重新连接...？

浏览器与 ComfyUI 后端的实时 websocket 连接已中断。后端可能已崩溃，某个自定义节点可能破坏了启动，或者浏览器/网络路径可能正在阻断连接。

failed to fetch server logs 和重新连接是同一件事吗？

不完全是。Failed to fetch server logs 通常是浏览器无法访问后端日志端点后出现的第二个症状。如果这是你看到的确切信息，请在检查终端后使用 无法获取服务器日志指南。

访问 ComfyUI 应该用 localhost 还是 127.0.0.1？

诊断时先使用 http://127.0.0.1:8188。如果这样可以访问，但局域网 IP、反向代理或远程 URL 失败，问题可能出在网络绑定、防火墙、VPN、代理或浏览器访问上，而不是 ComfyUI 本身。

相关指南

• ComfyUI 无法获取服务器日志
• ComfyUI 启动失败？如何更快诊断和恢复
• 如何修复 ComfyUI 插件导入失败错误
• ComfyUI 依赖冲突
• ComfyUI 常见问题与快速修复

参考来源

• ComfyUI 官方故障排查概览
• 官方自定义节点故障排查指南
• 官方 ComfyUI 更新故障排查