知仓学习社知仓学习社
打开 127.0.0.1:8188 只有空白页或一直转圈，界面加载不出来 / 全站资源搜索
搜索 更新 2026-10-02
报错 078 前端界面、浏览器与工作流加载 有来源可查

打开 127.0.0.1:8188 只有空白页或一直转圈，界面加载不出来

报错原文（原样） 
Chromium:
127.0.0.1/:1 An import map is added after module script load was triggered.
user.css:1 Failed to load resource: the server responded with a status of 404 (Not Found)
user.css:1 Failed to load resource: the server responded with a status of 404 (Not Found)
127.0.0.1/:1 Uncaught TypeError: Failed to resolve module specifier "@primevue/themes". Relative references must start with either "/", "./", or "../".
user.css:1 Failed to load resource: the server responded with a status of 404 (Not Found)
Firefox:
unreachable code after return statement tslib.es6.mjs:128:11
检索关键词 blank screen、Failed to resolve module specifier "@primevue/themes"、user.css:1 Failed to load resource、stuck loading forever、comfyui_frontend_package、空白页、一直转圈
先看这一句 服务端控制台已经打印出 "To see the GUI go to: http://127.0.0.1:8188"，但浏览器里页面全白，或一直停在加载动画上，无法与界面交互；换浏览器有时却正常。
适用版本 全版本通用；官方在 ComfyUI_frontend#4897 中认为 1.23.4 之后的问题已被后续版本修复，但社区仍不断报告新版本复现，故不能只靠升级判断 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器、全部主流环境

现象与触发场景

常见触发场景：

  • 更新 ComfyUI 或前端包（comfyui_frontend_package）之后首次启动
  • 安装了带前端扩展（web/JS extension）的自定义节点
  • 浏览器缓存里残留了旧版本前端 chunk
  • 浏览器装了会改写 User-Agent／注入脚本的隐私类扩展

根因

  • 带前端扩展的自定义节点没有适配新版前端：官方在自定义节点排查文档中明确列出这类节点的常见冲突现象就是 "Completely broken UI or blank screen"、"Unable to access ComfyUI frontend"、"Misaligned UI elements"，原因是前端在更新中改动、而节点尚未跟进
  • 前端包本身在特定版本上存在加载缺陷（ComfyUI_frontend#4897 报告 comfyui_frontend_package > 1.23.4 时界面不加载，<= 1.23.4 正常）
  • 浏览器缓存/扩展介入：维护者 christian-byrne 建议清理浏览器缓存；该 issue 的报告者最终定位到浏览器扩展 "Random User-Agent (Switcher)"，即使该扩展对 127.0.0.1 配置为关闭，也必须从扩展面板整体停用才恢复
  • 自定义节点的 /object_info 响应异常巨大或卡死，官方维护者 ltdrdata 在 ComfyUI#7329 指出该接口 "very slow or even unresponsive" 时应禁用全部自定义节点再试，即某些已安装节点会拖住它

解决步骤

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

  1. 先用 --disable-all-custom-nodes 判断是不是自定义节点造成的
    官方自定义节点排查文档给出的第一步：禁用全部自定义节点启动，如果界面恢复，就说明是某个自定义节点，继续做二分定位；如果问题依旧，就不是自定义节点问题，按前端/浏览器方向排查。Windows 便携版可以复制一份 run_nvidia_gpu.bat，改名后在里面加上该参数双击运行。
    .\python_embeded\python.exe -s ComfyUI\main.py --disable-all-custom-nodes --windows-standalone-build
    python main.py --disable-all-custom-nodes
  2. 用二分法锁定具体是哪个自定义节点
    官方文档给出的方法：每次只放回一半被禁用的节点，看问题是否复现，逐步缩小范围，直到定位到单个节点。优先怀疑带前端扩展（有 web/JS 目录、会注册前端钩子）的节点，官方文档说明这类节点 "cause the most issues"。也可以用 comfy-cli 的 bisect custom-nodes 功能辅助定位，维护者 huchenlei 在中文 issue 中推荐了这个做法。
    comfy-cli bisect custom-nodes
  3. 强制刷新并清缓存，再用无痕窗口/换浏览器交叉验证
    维护者建议先清浏览器缓存；issue 评论里给出的可操作做法是在页面上右键 → Inspect → Network → 勾选 "Disable cache" → 重新加载。另外用 Ctrl+Shift+R 或 Ctrl+F5 强制刷新，再用无痕窗口或 Firefox 打开一次：如果只有某一个浏览器白屏，基本可以判定是缓存或浏览器扩展问题而不是 ComfyUI 本身。
    Ctrl+Shift+R
    Ctrl+F5
  4. 排查浏览器扩展与强制回退前端版本
    把浏览器里会改写请求或注入脚本的扩展（UA 改写、去广告、脚本管理等）在扩展管理页整体停用，而不只是在站点设置里关掉。如果确认是新前端的问题，可以用 --front-end-version 把前端钉到已知可用的版本，例如 issue 评论中维护者与用户使用的 1.39.3、1.11.8；ComfyUI#7329 中有用户用该参数把被自动升级到 1.14 的前端钉回 1.11.8 后，界面恢复正常。
    --front-end-version Comfy-Org/ComfyUI_frontend@1.39.3
    --front-end-version Comfy-Org/ComfyUI_frontend@1.11.8

验证是否修好

服务端控制台不再有相关报错，浏览器 F12 的 Console 与 Network 中没有 404 或模块解析失败，页面完整渲染出节点画布，且能正常队列一个默认工作流。

补充说明

本条目合并了 ComfyUI_frontend#4897（有完整浏览器 Console 原文）与 ComfyUI#7329（stuck loading forever，含维护者 ltdrdata 的 /object_info 判断与 --front-end-version 处置）。ComfyUI#6451 "The browser keeps getting stuck in the loading animation when accessing comfyui" 与 ComfyUI#5376 "it loads? But the web browser remains blank" 是同类现象，但采集时 GitHub API 触发限流未能取到正文，故未引用其内部细节。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [182] （官方 issue）　[Bug]: ComfyUI blank screen on loading after upgrading the frontend be　https://github.com/Comfy-Org/ComfyUI_frontend/issues/4897
  2. [183] （官方 issue）　ComfyUI stuck loading forever since update　https://github.com/Comfy-Org/ComfyUI/issues/7329
  3. [68] （官方文档）　Troubleshooting Custom Node Issues　https://docs.comfy.org/troubleshooting/custom-node-issues
  4. [184] （官方 issue）　Freezing Interface & Workflow　https://github.com/Comfy-Org/ComfyUI/issues/5805

这条报错要用到的东西

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

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

同一类别的其他条目

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

返回报错库