适用于导入他人工作流后出现红色缺失节点、运行时找不到节点类型的情况。先保存工作流副本和原始下载地址;不要把“缺失节点”自动理解成电脑里完全没有相关文件。
从眼前的问题开始查。
这里只展示当前语言已发布的正文;中文阅读也可以搜索英文错误原文。
已发布知识库
第 4 页区别 mmcv 与 mmcv-lite,并将源码构建失败和运行期扩展加载失败分开处理。
多个 ComfyUI 实例可以按支持的配置引用已有模型目录,但共享文件不代表共享了 Python 环境、节点安装和工作流版本。本页重点解决“模型明明在磁盘上,当前实例却找不到”。
运行时 ckpt_name、lora_name 或其他下拉参数不在当前选项中。通常需要检查扫描目录、文件名、正在运行的实例和下拉框旧值,但这个错误也可发生在采样器等非文件选项上。
适用于启动或执行自定义节点时提示缺少 Python 模块。命令行显示“已安装”仍可能是另一个 Python 的结果;Windows Portable 尤其需要区分系统 Python 与内置解释器。
在 Mac 上加载某个 FP8 模型或执行节点时,出现转换到 MPS 不支持的 dtype 提示。需要确定是权重加载、解量化还是运算阶段受限,而不能据文件名认定所有量化模型都不支持。
Apple Silicon 上的任务触发 MPS 内存上限。Mac 使用统一内存,浏览器、其他应用、模型和中间张量会共同影响可用空间,不能把机器总内存全部视为可分配给当前生成任务。
转换失败与超出当前节点范围要分开检查;先核对请求实际提交的值,不要直接改节点定义或统一截断数字。
适用于安装或更新节点后,导入 NumPy 相关扩展时出现 ABI 报错。问题通常发生在编译扩展与 NumPy 的二进制接口之间,而不是工作流连线本身。
检查 wheel 的 Python、系统与 Torch 标签,避免把节点安装成功和底层推理库安装成功混为一谈。
日志里的 nvvfx 可能来自节点封装或原生 SDK 接口。只凭这一行,不能认定存在同名、可信且适用于当前环境的 pip 安装包。
区分 onnx、onnxruntime、GPU 构建与会话实际使用的执行提供程序,避免把所有错误当成缺包。
区分普通版、contrib 和 headless,检查同一命名空间的重复安装,再处理 DLL 或原生库错误。
结合退出状态、节点注册和当前工作流判断影响,不按日志颜色决定是否升级整个环境。
想让图更大,可能是在原画面之外生成新内容,也可能只是提高现有画面的像素分辨率。两者目标、节点与风险不同,选错工作流会造成看似尺寸正确但内容不符合预期。
适用于 pip 或 Manager 下载依赖时 HTTPS 证书验证失败。应修复可信证书链和代理配置;它不是显卡问题,也不宜通过永久关闭验证来处理。
适用于 pip 找不到某个依赖版本。先确认完整包名和版本限制,再检查 Python、操作系统、CPU 架构及下载源;这条提示不一定表示项目根本不存在。
适用于安装节点或升级时 pip 明确报告依赖版本互相冲突。安装器无法同时满足要求与网络下载慢是两种问题;应先读冲突链,而不是持续换镜像重试。
Portable 包含自己的 Python 与 ComfyUI 目录。最容易出错的操作,是把依赖安装到系统 Python,却期待嵌入式 Python 可以自动使用。此文按进程和路径解释如何避免两套环境混用。
ComfyUI 启动时无法绑定端口,通常需要区分已有正常实例和其他服务占用。多次双击启动脚本可能制造多个互相冲突的实例,但不能看到端口占用就立即杀掉所有 Python 进程。
请求包含若干加载和计算节点,但服务端没有找到本次要执行的有效输出节点。单纯在画布上生成 latent 或连接一些中间节点,并不必然构成完整执行目标。
该错误可能由旧版生成的 Python 消息代码与运行库不匹配引起。不要只看到 protobuf 就删除或降级整个环境中的所有相关依赖。
分别检查 PyAV 的 Python 入口、其使用的多媒体库,以及节点调用的外部 FFmpeg 程序。
某些三维或渲染节点可能分别依赖 PyOpenGL、可选的加速绑定和可用图形上下文。先确认异常发生在 Python 导入,还是运行时建立渲染上下文。