自定义节点排错：先禁用再二分

启动报错、节点变红、装完新节点就卡死？别急着重装 ComfyUI——多数 ComfyUI 自定义节点报错，花十分钟就能定位：先禁用全部节点确认范围，再用二分法锁定是哪一个。

症状

出现任一情况，优先怀疑自定义节点：

• 启动时控制台刷出成片红色导入失败报错（Failed to import、Cannot import … module for custom nodes 之类），节点菜单里缺节点。
• 加载工作流后，部分节点在画布上显示为红色。
• 刚装完新节点包，ComfyUI 卡在启动界面或直接崩溃。

第一反应：

启动日志出现 Failed to import 之类报错

先用 --disable-all-custom-nodes 启动一次，把"节点问题"和"ComfyUI 本体问题"分开。

节点在画布上显示红色

确认节点包已安装且已启用；刷新后仍是红色，说明该包导入失败，回启动日志找原因。

装新节点后启动卡住或崩溃

先禁用全部节点恢复启动，再用二分法找出问题节点。

快速检查（60 秒）

• 最近装过或更新过节点包？先回滚或卸载它。
• 用的是便携版（Portable）？排查时要改启动 .bat 加参数。
• 部分节点首次启动会联网下载模型，先检查网络和代理。
• 依赖要装进 ComfyUI 实际使用的那个 Python 环境，不是系统 Python。

排查三步

第 1 步：禁用全部自定义节点启动

便携版：用记事本打开平时双击的启动 .bat（NVIDIA 显卡是 run_nvidia_gpu.bat、AMD 是 run_amd_gpu.bat、CPU 是 run_cpu.bat），在启动命令末尾追加 --disable-all-custom-nodes，保存后重启。

源码或 venv 安装：在启动命令后加同一个参数。

能正常启动，问题在节点，进入第 2 步；仍报错，问题在 ComfyUI 本体或环境，先回排错总览。

第 2 步：二分法定位问题节点

把 custom_nodes 目录下的节点包平均分成两半，把一半临时移出目录（剪切到别处备份），只留另一半启动测试：

• 报错：问题在留下的这半，继续对半分。
• 正常：问题在被移走的半，换回来再对半分。

重复两三轮就能锁定单个节点包：10 个包最多 4 轮，比逐个试快得多。

第 3 步：修复或替换问题节点

• 先更新到最新版：多数报错是节点没跟上 ComfyUI 新版本接口。
• 按 README 补装依赖：进入节点目录，用 ComfyUI 所在的 Python 执行 pip install -r requirements.txt。
• 仍失败：带完整启动日志去该节点仓库提 issue，或删掉它换功能相同的替代节点。

升级条件

• 禁用全部节点后依然起不来：不是节点问题，转模型加载失败。
• 日志报错指向 torch、CUDA、显存而非 import：是环境问题，别在节点上耗时间。
• 更新、重装依赖后仍报错：去节点仓库 issue 区求助，附完整日志和 ComfyUI 版本号。

---

相关阅读：排错总览 · 模型加载失败 · 模板库：官方工作流一键加载