知仓学习社知仓学习社
浏览器控制台报 Failed to load resource: ERR_CONNECTION_REFUSED，页面打不开或功能全失效 / 全站资源搜索
搜索 更新 2026-10-02
报错 081 前端界面、浏览器与工作流加载 有来源可查

浏览器控制台报 Failed to load resource: ERR_CONNECTION_REFUSED，页面打不开或功能全失效

报错原文（原样） 
TypeError: Failed to fetch
Failed to fetch server logs
检索关键词 Failed to fetch、ERR_CONNECTION_REFUSED、ERR_EMPTY_RESPONSE、Failed to fetch server logs、Reconnecting、net::ERR_CONNECTION_REFUSED、连接被拒绝
先看这一句 页面能打开但功能全不可用：侧栏日志区显示 "Failed to fetch server logs"，执行到某个进度后出现 "Reconnecting"，随后抛出 TypeError: Failed to fetch；或者干脆连首页都打不开，浏览器控制台显示 ERR_CONNECTION_REFUSED。
适用版本 全版本通用 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

  • ComfyUI 后端进程没有启动、或已经中途崩溃退出
  • 端口被占用或被防火墙拦截，浏览器连的不是同一个端口
  • 从浏览器或第三方脚本以跨域方式访问 127.0.0.1:8188，被 CORS 拒绝
  • Docker/远程部署时只监听了 127.0.0.1，宿主机外部访问不到

根因

  • 后端未在监听。ComfyUI 的 HTTP 接口与 WebSocket 都挂在同一个服务上（官方文档 Server Overview 说明默认监听 127.0.0.1:8188，前端通过 HTTP 路由与 socket 消息与后端通信），后端一停，前端所有 fetch 都会失败并显示 Failed to fetch
  • 前后端不是同一端口或不是同一进程。ComfyUI Desktop 默认端口与便携版不同，官方文档与 ComfyUI Wiki 均记录便携版/命令行是 8188、桌面版是 8000，端口填错就表现为连接被拒绝
  • 浏览器侧限制。中文社区（CSDN 问答）有提问把 "ComfyUI提示执行失败：TypeError: Failed to fetch" 归因于后端未启动或跨域/网络配置异常，可作为线索；跨域方面 ComfyUI 官方确实提供了 CORS 开关，startup-flags 文档记录 --enable-cors-header 默认 disabled
  • 开发/调试环境下本地 127.0.0.1 被代理或 hosts 影响，请求没有真正到达服务

解决步骤

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

  1. 先确认后端到底有没有在监听
    在 ComfyUI 所在机器上直接请求根路径和状态接口。能返回内容说明后端活着，问题在浏览器侧；连接被拒绝说明后端没起来或端口不对，应回到启动终端看崩溃信息。官方文档说明默认监听 127.0.0.1:8188，且可用 --port 改端口、--listen 改监听地址。
    curl -i http://127.0.0.1:8188/
    curl -s http://127.0.0.1:8188/system_stats
    python main.py --port 8288
  2. 用 F12 分清是「请求失败」还是「请求被拒」
    F12 → Network，重放一次出错操作，看失败请求的真实状态：net::ERR_CONNECTION_REFUSED 表示根本没有服务在监听该端口；404 表示服务在但路径不对；CORS 类错误表示服务在但拒绝了来源。再对照 F12 → Console 的报错与后端终端的 traceback，两边时间戳对齐就能判断是谁先出问题。
  3. 需要跨来源访问时打开 CORS，并修正监听地址
    官方 startup-flags 文档记录 --enable-cors-header 默认 disabled，可带一个来源，或在不给值时用 * 允许全部来源。ComfyUI#11181 的讨论确认了默认行为会阻止外部来源的请求，用户 c0dezer019 也说明这正是他遇到的 "blocked by CORS"。局域网/跨机访问还需要 --listen 0.0.0.0 而不是默认的 127.0.0.1。
    python main.py --enable-cors-header
    python main.py --listen 0.0.0.0
    python main.py --tls-keyfile key.pem --tls-certfile cert.pem
  4. 排除代理与浏览器扩展干扰
    用无痕窗口打开同一地址（无痕默认不加载扩展），并用 127.0.0.1 与 localhost 两种写法各试一次。如果无痕正常而普通窗口不行，或换写法就好，问题在浏览器侧（扩展/代理/缓存），不要再去动 ComfyUI 的代码。

验证是否修好

curl 能拿到 / 页面与 /system_stats 的 200 响应，浏览器 Network 里对应请求全部为 200，侧栏 "Failed to fetch server logs" 消失，能正常队列并跑完一个工作流。

补充说明

ComfyUI#9171 只有现象与大量 "same problem" 回复，截至采集时仍为 open、未见维护者给出明确根因结论，因此本条的根因与解法取自官方 Server Overview / startup-flags / comms_routes 文档与 ComfyUI#11181 的 CORS 讨论，未把 #9171 的猜测当作结论。ComfyUI#9171 中 "Reconnecting" 与 "Failed to fetch server logs" 为原文照抄。

来源

按可信度排列：官方 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. [194] （官方文档）　Startup Flags　https://docs.comfy.org/development/comfyui-server/startup-flags
  4. [195] （官方 issue）　Local API access　https://github.com/Comfy-Org/ComfyUI/issues/11181

这条报错要用到的东西

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

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

同一类别的其他条目

【078】打开 127.0.0.1:8188 只有空白页或一直转圈，界面加载不出来 有来源 【079】工作流所有节点变红、提示缺少节点或 Cannot find node，无法执行 有来源 【080】新版前端与旧工作流不兼容：旧工作流节点错位、widget 丢失或值变成 undefined 有来源 【082】出图成功但看不到图：预览 404、保存的图片找不到 有来源 【083】WebSocket 断开／Reconnecting，进度条卡在 0% 但后端其实已经出图 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库