记录一下那天晚上的排查过程。启动界面时报 ImportError: cannot import name,某个自定义节点加载失败,整个界面卡在启动阶段。
刚开始盯着「节点目录残留旧版本文件」,折腾了半个多小时,排掉了。
把日志和配置对完,能解释这个现象的基本就这几处。节点依赖的包没有安装。也可能是依赖版本与主程序冲突。
另外,Python 环境与主程序不是同一个。
上来先看完整报错里缺的是哪个包
python main.py 2>&1 | Select-String -Pattern 'ImportError|ModuleNotFound'
随后按提示安装缺失依赖
pip install -r custom_nodes/ComfyUI-Manager/requirements.txt
接着把冲突的节点目录临时移出后再启动
python -c "import shutil;shutil.move('custom_nodes/old_node','custom_nodes/old_node.bak')"
等前面都确认过,再确认依赖装在同一个解释器里
python -c "import sys;print(sys.executable)"
怎么算真的好了,看的是同一批现象。界面能正常启动,节点列表完整,出图流程可以跑通,之前报错的节点也能正常使用。
一个坏节点就能拖垮整个启动流程,排查时先把自定义节点全部禁用再逐个加回来,比读堆栈快。报错文案容易误导,真正的原因往往在相邻那一层的日志里。