翻译节点可能在导入 Python 包时失败,也可能已能导入但没有所需语言模型。先确认节点实际调用的是 Argos Translate,不要因为名称相似安装别的翻译库。
从眼前的问题开始查。
这里只展示当前语言已发布的正文;中文阅读也可以搜索英文错误原文。
缺包、节点与版本冲突
第 1 页混合节点的异常可能发生在导入,也可能发生在图像数组运算。包名、输入通道、数组类型和透明度参数需要分别核对,不能用“强制转成四通道”覆盖所有情况。
适用于升级后某个节点导入失败,或提示某模块缺少过去使用的名称、属性。它与 No module named 不同:模块可能已经存在,只是调用的接口或导入关系不再满足要求。
以 v0.37.0 的 Qwen 2.1 节点为样本,区分核心发行版本、节点类名和画布显示名;不冒充完整核心节点导出。
记录包标识、仓库、观察到的 1.7.9 版本和声明依赖;节点说明与视频报错相互关联,不把功能名当技术类名。
从工作流里发现一个缺失节点后,需要确定它来自哪个项目、安装代码和依赖,并检查服务端注册。下载仓库成功只是其中一步,不应直接当成节点已经可用。
自定义验证器主动拒绝与抛出异常是两类错误;先读取对应 node_errors,再决定检查输入、资源还是节点代码。
视频节点报 decord 缺失、打不开文件或无法启用 GPU 时,要分别检查 Python 绑定、输入媒体和原生构建能力。Torch 能用 CUDA,并不证明 decord 也具备 GPU 解码。
配置比较节点可能在导入 DeepDiff、比较复杂对象或输出比较结果时失败。比较结果显示“不相同”通常是业务结果,不应被当成依赖错误来修复。
把报错里的导入名称、安装名称和实际运行环境分开检查,避免装错包或装到另一套 Python。
人脸相关节点提示 dlib 缺失时,先区分根本没有 Python 绑定,还是安装过程中原生编译失败。不要下载不明来源的 DLL 或 wheel 拼进环境。
看到缺少 flash_attn 或 wheel 构建失败,不要立即替换 Torch。节点使用的 FlashAttention 路线、GPU、操作系统和编译工具需要同时匹配。
适用于 Manager 安装/更新仓库时找不到 Git,或系统终端可以执行 Git、ComfyUI 进程却不可以。这里要核对的是服务进程的环境,不只是当前打开的另一个终端。
Hydra 的导入名和常见分发包名不同。模块缺失与配置搜索路径错误要分别处理,不要把工作流导入失败归结为随便安装一个同名包。
使用 FaceID 时出现 insightface 模块缺失、构建 wheel 失败,或者包安装后仍无法初始化。这里需要分别确认解释器、二进制构建、运行后端与模型资源。
当不知道哪一个扩展造成报错、白屏或更新故障时,用可复核的分组对照替代随机卸载。目标是定位最小触发集合,而不是把所有第三方节点都判定有问题。
先判断主包缺失还是某项功能缺少额外依赖,不把最新安装命令强加给旧节点。
两种导入命名会出现在不同项目和版本中。不要认为安装其中任意一个就一定满足所有节点,也不要把 checkpoint 反序列化失败当成单纯缺包。
先确认 llama-cpp-python 的实际环境与后端,再处理编译日志或模型加载,不按 GGUF 后缀乱换加载器。
适用于升级后找不到 Manager 按钮,或手动安装后界面没有变化。当前新旧 Manager 界面、Desktop 与手动安装的入口不同,不能照着旧截图判断一定没装好。
适用于 Manager 拒绝从 URL 安装、修改或执行某些敏感操作。首先把它看作权限边界触发,而不是程序损坏;尤其不能在公共云或共享机器上直接弱化全局安全配置。
适用于 Windows 环境启动 Manager 时出现 Overlapped Object 相关异常。应确认它来自 Manager 初始化的异步网络流程;不能把同一句底层异常的所有来源当成同一种配置问题。
节点可能在 pip 解析依赖时被阻止,也可能装好后在导入原生扩展时失败。先读取当前 MediaPipe 发行包的依赖,不把历史版本的限制套到所有新版本。
适用于导入他人工作流后出现红色缺失节点、运行时找不到节点类型的情况。先保存工作流副本和原始下载地址;不要把“缺失节点”自动理解成电脑里完全没有相关文件。