夜雨聆风学习资料网

ARTICLE · 1138274

插件挂了三个月,ComfyUI一句没报.

插件挂了三个月,ComfyUI一句没报.

结论先放这里:「能出图」不能证明你的 ComfyUI 是好的。

我 10 月 8 号在那台 5060Ti 素材机上把 ComfyUI 0.33.0 重启了一次,出图一切正常。但启动日志里有这么一行:

[INFO] 0.0 seconds (IMPORT FAILED): C:\AI\ComfyUI\app\custom_nodes\ComfyUI-Manager

「IMPORT FAILED」。插件管理器,导入失败。

我的第一个念头是「这得三个月了吧」——因为这台机器上一次动 ComfyUI 是 9 月初那批电商出图。翻了下这台机器的状态:出图照常、工作流照跑、图片照存,没有任何一个环节提示过我不对。

五个可选判据,四个都在骗你

我把「怎么判断一个自定义节点是好的」这件事拆了一遍。你可能会用的判据有五个,实际效果是这样:

判据
看起来
实际情况
能正常出图
✅ 正常
❌ 完全无关。Manager 挂了,出图不受任何影响
「Get-Process python」 有进程
✅ 有
❌ 只能证明服务器活着,不证明节点加载成功
端口 8188 通
✅ 通
❌ 同上,只证明 HTTP 服务在听
节点目录存在
✅ 目录在,30 多个文件全在
❌ 文件在 ≠ 能 import,两回事
翻启动日志
—
✅ 唯一有效。失败只在这行 INFO 里

我逐个验过:

节点目录 「C:\AI\ComfyUI\app\custom_nodes\ComfyUI-Manager」 是完整的——「__init__.py」、「scanner.py」、「cm-cli.py」、「custom-node-list.json」(3.0 MB)、「github-stats.json」(1.0 MB),一个不缺。进程在跑、端口在听、图在出。所有「看起来没问题」的判据,全绿。

问题只藏在启动那 2 秒里的一行 INFO 上。

根因:是 git,不是 Manager

我把它的 import 单独拽出来跑了一遍,拿到完整的 traceback:

File "C:\AI\ComfyUI\app\custom_nodes\ComfyUI-Manager\glob\manager_server.py", line 13, in <module>import gitFile "C:\AI\ComfyUI\venv\Lib\site-packages\git\__init__.py", line 298, in <module>raise ImportError("Failed to initialize: {0}".format(_exc)) from _excImportError: Failed to initialize: Bad git executable.

「Bad git executable.」

顺着查下去:「C:\AI\ComfyUI\venv」 里 GitPython 3.1.60 是装好的,但机器上没有 git 可执行文件。我按它说的四个常见路径挨个测:

C:\Program Files\Git\cmd\git.exe FalseC:\Program Files\Git\bin\git.exe FalseC:\Program Files (x86)\Git\cmd\git.exe FalseC:\AI\git\cmd\git.exe False

「Get-Command git」 也是空——这台机器压根没装 git。

GitPython 的文档写得很直白:git 必须能在 「$PATH」 里找到,或者通过 「GIT_PYTHON_GIT_EXECUTABLE」 指定,或者用 「git.refresh()」 显式传全路径。三者都不满足,import 阶段就抛异常。

所以这不是 Manager 的问题。是 Manager 的一个依赖(GitPython)连带着需要一个外部 exe,而这个 exe 不在。Manager 只是第一个撞上去的人。

三条「看起来没问题」,各错在哪

我原先的判据
为什么错
正确的判据
能出图就行
出图走的是 「nodes.py」 + 已加载的节点;某个自定义节点 import 失败,不影响其它节点运行
节点数对得上吗?启动日志有 IMPORT FAILED 吗?
目录在、文件全
文件完整只说明磁盘上有代码,不说明Python 能把它 import 进来
该节点的接口通不通
「pip list」 里有依赖
依赖装了 ≠ 运行时能找到它要的外部程序
外部 exe 在不在 「$PATH」 / 环境变量里

第三条是我这次真正长记性的一条。「pip list」 里 GitPython、PyGithub、matrix-nio、typer、rich、toml 全在——但 Typer 是好的、Rich 是好的,因为它们是纯 Python 包,不需要外部 exe。GitPython 要调 git.exe,机器上没有。同一个 requirements 列表里,一半能过一半不能过。

我还顺手翻了 Manager 自己的 「requirements.txt」,一共 11 项:「GitPython」、「PyGithub」、「matrix-nio」、「transformers」、「huggingface-hub」、「typer」、「rich」、「typing-extensions」、「toml」、「uv」、「chardet」。我实测的结果是——「PyGithub」 和 「matrix-nio」 这两个,跟 GitPython 一样,压根没装上。

也就是说:这行 IMPORT FAILED 只是冰山尖。底下还压着两个没装的依赖。

一个动作点

每次重启 ComfyUI 后,去日志里搜两个串。

Select-String -Path D:\comfy_out_1008.log -Pattern "IMPORT FAILED"

再对一次节点总数(正常服务下会有上千个节点类型,API 里能直接问):

curl -s http://127.0.0.1:8188/object_info | python -c "import sys,json;print(len(json.load(sys.stdin)))"

那次我实测是 1209 个。改天如果变成 1100 出头,说明有节点掉了,而出图还是会照常出。

写进你的开机自检脚本,两行,成本几乎为零。回报是:你不会在客户交付前一天才发现某个环节的插件早就不在了。

参考来源

1. 本机 2026-10-08 ComfyUI 启动日志原文:「[INFO] 0.0 seconds (IMPORT FAILED): C:\AI\ComfyUI\app\custom_nodes\ComfyUI-Manager」

2. 本机 2026-10-08 单独 import 复现的完整 traceback(「manager_server.py」 line 13 → 「git/__init__.py」 line 298 → 「ImportError: Failed to initialize: Bad git executable.」)

3. 本机 「Get-Command git」 实测为空;四个常见 git 安装路径 「Test-Path」 全为 「False」

4. 本机 「C:\AI\ComfyUI\venv」 实测:「GitPython」 3.1.60 已装;「PyGithub」、「matrix-nio」 import 失败

5. 「C:\AI\ComfyUI\app\custom_nodes\ComfyUI-Manager\pyproject.toml」(version 3.41,dependencies 11 项原文)

6. 「C:\AI\ComfyUI\app\custom_nodes\ComfyUI-Manager\requirements.txt」 原文

7. 本机 「ComfyUI-Manager」 目录清单实测(「scanner.py」 61928 B、「cm-cli.py」 41256 B、「custom-node-list.json」 3004349 B、「github-stats.json」 1021363 B)

8. 本机 「http://127.0.0.1:8188/object_info」 实测返回 1209 个节点类型(2026-10-08)

9. 本机 「C:\AI\ComfyUI\app\comfyui_version.py」(「__version__ = "0.33.0"」)

10. GitPython 官方文档:「git」 可执行文件的四种配置方式(「$PATH」 / 「GIT_PYTHON_GIT_EXECUTABLE」 / 「git.refresh()」 / 默认搜索路径)

数据说明:文中日志、traceback、路径检测结果、节点总数 1209 均为本机 2026-10-08 实录。文中「三个月」为按该机上一次运行 ComfyUI 时间(2026-09-04 产出目录时间戳)到本日的推断,非精确故障起始时间。「一千多个节点」为实测值,不同安装的节点数会因已装插件而不同。

声明:本文为原创实操记录。文中提到的 「IMPORT FAILED」 判据与节点计数命令为个人做法,不构成对任何工具的官方结论。如有侵权,请联系删除。

🔔 深耕 AI 干货 | 点名片订阅,上新早知道

💡 仍有疑问?一键呼叫在线答疑

✅ 全时段AI查询

✅ 专属个性化方案建议

⬇️ 长按识别二维码直达咨询

私信AI回复 | 24小时在线答疑

长按识别二维码,进入公众号发消息咨询

📊 硬件实测库 · 小程序

四十多个模型跑不跑得动你的机器,先在这里算一遍再下单。

🧮 适配器 · 45 模型 × 33 机型 | 🔍 核验器 · 商用判定🚀 部署单 · 14 类场景 | 📈 对照台 · 9 台真机实测

扫码进入「硬件实测库」小程序

#丘山录  #ComfyUI  #自定义节点  #静默失败  #本地部署  

相关学习资料