快速问题诊断

如果你遇到以下任何问题,很可能是由自定义节点引起的:

  • ComfyUI 崩溃或无法启动
  • 控制台/日志中出现”Failed to import”(导入失败)错误
  • UI 完全损坏或显示空白屏幕
  • “Prompt execution failed”(提示执行失败)错误
  • 应该可用的节点丢失

这是自定义节点问题吗?

大多数 ComfyUI 问题都是由自定义节点(扩展)引起的。让我们检查是否是这种情况。

步骤 1:禁用所有自定义节点后测试

在禁用所有自定义节点的情况下运行 ComfyUI:

从设置菜单中启动禁用自定义节点的 ComfyUI 桌面版

或手动运行服务器:

cd path/to/your/comfyui
python main.py --disable-all-custom-nodes

结果:

  • 问题消失:自定义节点导致问题 → 继续步骤 2
  • 问题仍然存在:不是自定义节点问题 → 报告问题

步骤 2:找到有问题的自定义节点

我们将使用二分搜索快速找到哪个自定义节点导致问题。这比逐个测试节点要快得多。

选项 A:使用 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

二分工具将自动启用/禁用节点并引导你完成整个过程。

选项 B:手动二分搜索

如果你更喜欢手动操作或没有安装 Comfy CLI,请按照以下步骤操作:

二分搜索的工作原理

我们不是逐个测试每个节点(可能需要几个小时),而是反复将节点分成两半:

8 个节点 → 测试 4 个节点 → 测试 2 个节点 → 测试 1 个节点 ✓

8 个节点的示例:
1. 测试节点 1-4:问题仍然存在 ✓ → 问题在剩余节点 5-8 中
2. 测试节点 5-6:问题消失 ✓ → 问题在节点 7-8 中  
3. 测试节点 7:问题仍然存在 ✓ → 节点 7 是问题所在!

这只需要 3 次测试,而不是测试所有 8 个节点。

二分搜索过程

开始之前,请创建备份你的 custom_nodes 文件夹,以防出现问题。

创建临时文件夹

# 创建备份和临时文件夹
mkdir "%USERPROFILE%\custom_nodes_backup"
mkdir "%USERPROFILE%\custom_nodes_temp"

# 首先备份所有内容
xcopy "custom_nodes\*" "%USERPROFILE%\custom_nodes_backup\" /E /H /Y

找到有问题的节点

  1. 列出你的自定义节点:

    dir custom_nodes
  2. 将节点分成两半:

    假设你有 8 个自定义节点。将前一半移动到临时存储:

    # 将前一半(节点 1-4)移动到临时文件夹
    move "custom_nodes\node1" "%USERPROFILE%\custom_nodes_temp\"
    move "custom_nodes\node2" "%USERPROFILE%\custom_nodes_temp\"
    move "custom_nodes\node3" "%USERPROFILE%\custom_nodes_temp\"
    move "custom_nodes\node4" "%USERPROFILE%\custom_nodes_temp\"
  3. 测试 ComfyUI:

    python main.py
  4. 解释结果:

    • 问题仍然存在:问题在剩余节点(5-8)中
    • 问题消失:问题在移动的节点(1-4)中
  5. 缩小范围:

    • 如果问题仍然存在:将剩余节点的一半(例如节点 7-8)移动到临时文件夹
    • 如果问题消失:将临时节点的一半(例如节点 3-4)移回 custom_nodes
  6. 重复直到找到单个有问题的节点

视觉示例

让我们通过一个包含 8 个自定义节点的完整示例:

📁 custom_nodes/
├── 🔧 ComfyUI-Manager
├── 🎨 ComfyUI-Custom-Scripts  
├── 🖼️ ComfyUI-Impact-Pack
├── 🔄 ComfyUI-Workflow-Component
├── 📊 ComfyUI-AnimateDiff-Evolved
├── 🎭 ComfyUI-FaceRestore
├── ⚡ ComfyUI-Advanced-ControlNet
└── 🛠️ ComfyUI-Inspire-Pack

第 1 轮: 将前 4 个移动到临时文件夹

  • 测试 → 问题仍然存在 ✓
  • 问题在:ComfyUI-AnimateDiff-Evolved、ComfyUI-FaceRestore、ComfyUI-Advanced-ControlNet、ComfyUI-Inspire-Pack

第 2 轮: 将剩余 4 个中的 2 个移动到临时文件夹

  • 测试 → 问题消失 ✓
  • 问题在:ComfyUI-Advanced-ControlNet、ComfyUI-Inspire-Pack

第 3 轮: 将剩余 2 个中的 1 个移动到临时文件夹

  • 测试 → 问题仍然存在 ✓
  • 找到了! ComfyUI-Inspire-Pack 是有问题的节点

步骤 3:修复问题

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

选项 1:更新节点

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

选项 2:替换节点

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

选项 3:报告问题

联系自定义节点开发者:

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

选项 4:移除节点

如果没有修复可用且你不需要该功能:

  1. custom_nodes/ 中移除有问题的节点
  2. 重启 ComfyUI

报告问题

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

自定义节点特定问题

联系自定义节点开发者:

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

ComfyUI 核心问题

桌面应用问题

前端问题

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