知仓学习社知仓学习社
一个节点包报错导致 / 或看似导致所有自定义节点加载中断（Cannot import ... custom_nodes） / 全站资源搜索
搜索 更新 2026-10-02
报错 024 依赖缺失与自定义节点安装失败 有来源可查

一个节点包报错导致 / 或看似导致所有自定义节点加载中断（Cannot import ... custom_nodes）

报错原文（原样） 
Traceback (most recent call last):
File "G:\ai\progs\sd\ComfyUI___comfyanonymous.gh\nodes.py", line 2152, in load_custom_node
module_spec.loader.exec_module(module)
File "G:\ai\progs\sd\ComfyUI___comfyanonymous.gh\custom_nodes\anynode\__init__.py", line 8, in <module>
from .nodes.any import NODE_CLASS_MAPPINGS, NODE_DISPLAY_NAME_MAPPINGS, AnyNode
ModuleNotFoundError: No module named 'G:\\ai\\progs\\sd\\ComfyUI___comfyanonymous'
检索关键词 Cannot import、module for custom nodes、(IMPORT FAILED)、load_custom_node、--disable-all-custom-nodes、comfy-cli node bisect、custom_nodes
先看这一句 启动时 custom_nodes 下多个目录接连报导入失败，界面里大量节点变红或干脆不出现；工作流加载时提示一堆 node types were not found。
适用版本 全版本通用（这是加载机制本身的行为，不是某个版本的 bug） · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

  • 更新 ComfyUI 或某个节点后，原本正常的节点开始集体导入失败
  • 节点目录名里带多余下划线、连字符或空格，import 语句按包名解析时失败
  • 只有一个节点包坏了，但日志太长，误以为是所有节点都坏了

根因

  • ComfyUI 用 importlib 逐个 exec_module 加载 custom_nodes 子目录，任何一个包在顶层抛异常只影响它自己，但日志会连续刷出多条 Traceback，看起来像“全部崩了”
  • 节点 `__init__.py` 里写了基于目录名的相对导入或动态 import，目录名不合法/含特殊字符时解析成错误的模块名
  • 节点与当前 ComfyUI 前端/后端版本不兼容，顶层代码在 import 阶段就抛错

解决步骤

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

  1. 先禁用全部自定义节点，判断问题是否来自节点
    官方排障第一步：加 --disable-all-custom-nodes 启动。问题消失说明是节点引起；问题依旧说明与节点无关，转向其他排查方向。便携版可复制一份 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. 从启动日志里读出真正出错的目录（不是整段日志）
    在日志里搜 `Cannot import` 或 `(IMPORT FAILED)`，这两个标记后面紧跟的就是具体路径，例如 `Cannot import C:\...\custom_nodes\ComfyUI-WD14-Tagger module for custom nodes: ...`。冒号后面的那句才是真因（缺模块、DLL 失败、路径错误），Traceback 里最关键的是最后一段 `File "...custom_nodes\<名字>\..."` 所在目录。
  3. 用二分法（或 comfy-cli 自动化）锁定单一节点
    官方推荐做法：把 custom_nodes 里的节点分两半，先移走一半再启动，根据问题是否出现确定坏节点在哪一半，重复直到定位到单个目录。已装 comfy-cli 的可让它自动完成启用/禁用与判定。操作前务必备份 custom_nodes。
    comfy-cli node bisect start
    comfy-cli node bisect good
    comfy-cli node bisect bad
    comfy-cli node bisect reset

验证是否修好

禁用可疑节点后重启，启动日志中不再出现该目录的 (IMPORT FAILED)，且原先变红/缺失的节点恢复正常；再逐个放回节点确认只剩这一个有问题。

补充说明

本条给出的报错原文取自一个真实案例（ComfyUI 安装路径里带 `___` 等特殊字符导致模块名解析失败），它示范了“单节点失败看起来像全体失败”的形态；实际触发文本会随缺失模块不同而变化，请以你自己日志中 Cannot import 后面的路径为准。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [68] （官方文档）　自定义节点问题排查 / Troubleshooting Custom Node Issues　https://docs.comfy.org/troubleshooting/custom-node-issues
  2. [69] （官方 issue）　comfy failing to import any custom node after update with comfy-cli · 　https://github.com/Comfy-Org/ComfyUI-Manager/issues/1730
  3. [70] （官方 issue）　Custom nodes no longer being imported when Comfy starts · Issue #7554　https://github.com/Comfy-Org/ComfyUI/issues/7554

本条报错提到的节点仓库

下面这些节点仓库的名字出现在本条报错的正文里。这里只说「名字出现过」，没有断定问题就是它引起的； 点进去可以看这个包的用途、适配模型与下载量。

pythongosssss/ComfyUI-WD14-Tagger 节点库

这条报错要用到的东西

按本条报错所属的类别（依赖缺失与自定义节点安装失败）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

常用节点速查包常用节点参数小抄 / 常见连法示意图 待挂载
节点库按用途找节点仓库，附适配模型与下载量 板块

同一类别的其他条目

【023】报错 No module named 'insightface'（IPAdapter 人脸加载器 / ReActor 换脸节点不可用） 有来源 【025】报错 No module named 'cv2'（controlnet_aux / WanVideoWrapper 等节点导入失败） 有来源 【026】报错 ImportError: DLL load failed while importing onnxruntime_pybind11_state（缺 Visual C++ 运行库 / onnxruntime 版本不匹配） 有来源 【027】报错 ImportError: cannot import name 'cached_download' from 'huggingface_hub'（diffusers 与新版 huggingface_hub 不兼容） 有来源 【028】工作流加载后提示缺少节点 / 节点显示红色（Warning: Missing Node Types） 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库