如果你在用ComfyUI搭建AI工作流时遇到过某个节点突然变红、点击后弹出一串英文错误信息的情况——这篇文章就是为你准备的。
一、为什么会出现红色报错
ComfyUI的节点系统基于Python脚本运行。当某个节点的输入参数不符合要求或依赖库缺失时，该节点会显示为红色背景并停止执行。这通常发生在以下几种场景：
第一种：模型权重文件路径错误（最常见）
当你从网上下载别人的工作流JSON文件导入自己的ComfyUI时，如果对方使用的模型文件在你本地不存在或存放路径不同，Load Checkpoint节点就会报红色错误。解决方法是检查右侧队列面板中的具体报错信息——通常会明确告诉你缺失哪个文件名。去HuggingFace或Civitai下载对应的.safetensors文件后放入models/checkpoints目录即可。
第二种：自定义节点插件未安装
别人的工作流中用到了ComfyUI-Impact-Pack或ComfyUI-Manager等第三方插件，而你本地没有安装。这种情况下报错信息会包含"ModuleNotFoundError"字样。解决步骤：打开ComfyUI Manager（点击顶部工具栏的Manager按钮）→ 搜索缺失的节点名称 → 点击Install安装。
第三种：输入类型不匹配
例如某个节点需要IMAGE类型的输入，但你连入的是LATENT类型的数据。ComfyUI不会自动转换数据类型，所以会报错。解决方法是在两个节点之间添加类型转换节点——从LATENT转IMAGE需要用VAE Decode节点，反之用VAE Encode节点。
二、高频报错清单及修复方法
"No module named 'xxx'"
缺少Python依赖库。在ComfyUI根目录打开命令行，执行 pip install xxx 安装缺失的包。如果不确定具体名称，先完整复制错误信息中的模块名。
"CUDA out of memory"
显存不足。解决方法：降低分辨率（如从1024×1024改为512×512）；在ComfyUI启动参数中添加 --lowvram 模式；或者关闭其他占用GPU的程序。
"Checkpoint file not found"
模型文件缺失或路径配置错误。检查 models/checkpoints 目录下是否存在报错中提到的文件名，注意大小写必须完全一致。
"Invalid image size: must be multiple of 64"
分辨率不是64的整数倍。将宽度和高度调整为800×1200或512×768等标准尺寸即可。
三、预防报错的最佳实践
导入他人工作流前先备份自己的当前项目（File → Save Workflow）；第二，安装新节点插件后务必重启ComfyUI服务；第三，定期更新ComfyUI核心程序和所有自定义节点到最新版本——很多报错是因为旧版插件与新版核心程序不兼容导致的。
