关于自定义节点问题排查,本篇文档的总体思路如下:

如何禁用所有的自定义节点?

从设置菜单中启动禁用自定义节点的 ComfyUI 桌面版 设置菜单-禁用自定义节点 或手动运行服务器:
cd path/to/your/comfyui
python main.py --disable-all-custom-nodes
结果:
  • 问题消失:自定义节点导致问题 → 继续步骤 2
  • 问题仍然存在:不是自定义节点问题 → 报告问题

二分法

在本篇中我们将会介绍使用二分搜索来进行自定义节点问题排查的思路,也就是一次排查一半的自定义节点,直到定位到导致问题的自定义节点 具体思路清参考下面的流程图,即每次启用所有未启用节点的一半,看看对应的问题是否出现,直到定位到对应的自定义节点是哪个

两种排查方法

在本篇文档中,我们将排查的自定义节点分为两类 自定义节点类型
  • A:包含前端扩展的自定义节点
  • B: 常规节点
首先让我们先了解不同类型的自定义节点可能导致的问题和原因
对于自定义节点我们又特别需要对包含前端扩展的自定义节点进行优先排查,这类节点导致的问题是最多的, 他们主要的冲突是与 ComfyUI 前端版本更新产生的冲突。常见的一些问题有:
  • 工作流无法执行
  • 节点预览图丢失
  • UI元素错位
  • 无法进入 ComfyUI 前端
  • UI 完全损坏或显示空白屏幕
  • 无法和 ComfyUI 后端正常通信
  • 节点之间的连线无法正常工作
  • 等等
常见这类节点导致的原因是因为:
  • 我们在对前端进行更新过程中进行了一些修改调整,这些自定义节点没有及时更新
  • 用户常常在更新过程中只是更新了 ComfyUI 并没有对自定义节点进行同步升级,虽然作者进行了更新,但是用户并没有在使用最新的兼容版本
  • 作者停止了维护,导致对应的自定义节点扩展无法和前端相互兼容

使用二分法进行排查

这两种上面两种不同的自定义节点问题里,自定义节点前端扩展和 ComfyUI 的冲突较为常见,我们会优先排查这类节点,后续的整体的问题排查思路如下

1.排查自定义节点的前端扩展

1

禁用所有插件的前端扩展

禁用所有插件的前端扩展 在启动 ComfyUI 后,在设置菜单中找到 扩展 菜单,并参考上图步骤禁用所有第三方扩展
2

重启一次 ComfyUI

在首次禁用前端扩展后,建议重启一次 ComfyUI 来保证能够顺利地禁用所有的前端扩展加载
  • 如果问题消失,那么问题就是由自定义节点的前端扩展引起的,我们可以继续进行下一步进行二分法进行排查
  • 如果问题仍然存在,那么问题就不是由自定义节点的前端扩展引起的,请参考本文另外一部分自定义节点扩展问题排查的思路
3

使用二分搜索定位问题节点

使用本文开头提到的方法来进行问题排查,一次启用一半的自定义节点,直到找到导致问题的自定义节点 启用前端扩展 参考图片,对一半的前端扩展进行启用,另外如果对应的扩展名称都相似,那么说明他们是来自同一个自定义节点的前端扩展
4

后续处理

如果找到问题自定义节点请参考本文的问题修复部分来进行自定义节点的问题修复
使用这种方法,你不用多次重启 ComfyUI 仅需要在每次启用 / 禁用自定义节点的前端扩展后重载 ComfyUI 即可, 而且你的排查范围也只是在有前端扩展的节点里,会大大缩小节点排查范围

2. 通用的自定义节点排查方法

1

使用二分搜索定位自定义节点

对于二分搜索定位的方法,除了手动之外我们也有使用 comfy-cli 来进行自动化的二分搜索,具体方法如下:
使用 Comfy CLI 需要你具有一定的命令行使用经验,如果你对此不擅长,请使用手动二分搜索如果你已安装 Comfy CLI,那么 Comfy CLI 可以允许你使用自动化的二分工具来找到有问题的节点:
# 开始二分会话
comfy-cli node bisect start

# 按照提示操作:
# - 使用当前启用的节点集测试 ComfyUI
# - 如果问题消失,标记为 'good':comfy-cli node bisect good
# - 如果问题仍然存在,标记为 'bad':comfy-cli node bisect bad
# - 重复直到识别出有问题的节点

# 完成后重置
comfy-cli node bisect reset
二分工具将自动启用/禁用节点并引导你完成整个过程。

修复自定义节点问题

一旦你识别出有问题的自定义节点:

选项 1:更新节点

  1. 检查 ComfyUI 管理器中是否有可用更新
  2. 更新节点并再次测试

选项 2:替换节点

  1. 寻找具有类似功能的替代自定义节点
  2. 查看 ComfyUI 注册表 寻找替代方案

选项 3:报告问题

联系自定义节点开发者:
  1. 找到节点的 GitHub 仓库
  2. 创建问题并包含:
    • 你的 ComfyUI 版本
    • 错误消息/日志
    • 重现步骤
    • 你的操作系统

选项 4:移除节点

如果没有修复可用且你不需要该功能:
  1. custom_nodes/ 中移除有问题的节点
  2. 重启 ComfyUI

报告非自定义节点导致的问题

如果问题不是由自定义节点引起的,请参考通过故障排除概述了解其他常见问题。

自定义节点特定问题

联系自定义节点开发者:
  • 找到节点的 GitHub 仓库
  • 创建问题并包含你的 ComfyUI 版本、错误消息、重现步骤和操作系统
  • 查看节点文档了解已知问题

ComfyUI 核心问题

桌面应用问题

前端问题

对于一般安装、模型或性能问题,请参见我们的故障排除概述模型问题页面。