更新或安装扩展后白屏：分开检查浏览器与 Python 后端

现象与适用范围

浏览器打不开正常画布、控件消失或白屏，但后端终端可能仍在运行。需要区别静态资源加载失败、前端扩展冲突和后端根本没启动，不能看到白屏就重装所有模型。

检索用原文或片段（具体编号、数值和文件名随环境变化）：

Failed to fetch dynamically imported module
TypeError
blank screen

已核对的依据

官方自定义节点排错提供前端扩展隔离与后端节点排错两条路径。更新说明也区分前端包、核心和模板；仅更新其中一项并不证明整套接口已经匹配。 D02 D07

需要区分的情况

1. 浏览器缓存或网络代理返回了不匹配的前端资源。

2. 某扩展的 JavaScript 与当前前端 API 不兼容。

3. 服务端启动失败、代理路径不正确或静态资源请求被拒绝，前端只是最终表现。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 先看后端终端是否已输出监听地址；用该地址确认服务存在，再打开浏览器开发者工具的 Console 和 Network。

第 2 步。 保存工作流后在无痕窗口或新的浏览器配置中对照，避免立即清除唯一的本地未保存数据。

第 3 步。 如果能打开设置，用“扩展”菜单禁用第三方前端扩展，重启后分组恢复。如果白屏使设置无法打开，先备份安装，再按对应安装方式支持的“禁用全部自定义节点”方法做基线对照，并分组恢复以定位触发项。基线恢复只缩小原因范围，不能单凭这一步认定某个扩展有问题。

第 4 步。 记录第一条资源/脚本错误、前端和扩展版本，在副本验证更新或回退，避免同时修改网络和依赖。

如何判断处理有效

画布、节点操作和基础请求恢复，并且刷新后无同一脚本错误。只有首页显示不代表扩展全部可用。

注意事项与尚未确认的部分

关闭扩展不会撤销它此前安装的 Python 依赖。清浏览器存储可能丢失未同步工作，应先备份。

资料核对日期：2026-09-26。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。

原始资料

• D02 · ComfyUI custom node troubleshooting。核对：2026-09-26。
• D07 · How to update ComfyUI。核对：2026-09-26。

相关排查与操作

• 如何用最小环境和二分法定位自定义节点冲突
• 无法连接 127.0.0.1:8188：先确认服务实际在哪里运行
• 核心更新了却找不到新节点或模板：核对多个组件版本