ComfyUI 升级后旧工作流节点变红，通常是因为自定义节点版本不兼容或缺失依赖，最推荐通过 ComfyUI Manager 更新或安装缺失节点，操作前务必备份原始工作流文件以防配置丢失。
先说结论：节点变红多为自定义节点缺失或接口变更，优先使用管理器修复，关键业务场景需保留旧版本环境。
- 先确认：区分节点是缺失自定义插件还是内部代码报错
- 先处理：通过 ComfyUI Manager 安装缺失节点或回退版本
- 再验证：重新队列提示词并检查控制台无报错
命令速用版
若通过 Git 部署 ComfyUI，可使用以下命令更新核心及管理器，适合熟悉命令行的用户：
cd ComfyUI git pull cd custom_nodes/ComfyUI-Manager git pull
若使用整合包，直接在管理器界面点击 Update All 按钮即可。
为什么会这样
节点变红本质是工作流定义的节点类在当前环境中无法实例化。
ComfyUI 核心更新可能废弃旧 API，导致依赖特定接口的自定义节点失效。另外，工作流导入时若本地未安装对应的自定义节点插件，系统无法识别节点类型，也会标记为红色报错状态。公开资料中没有看到可靠的量化数据说明具体多少比例的更新会导致破坏，但社区反馈频繁发生在核心版本大更新后。
分步处理
按以下顺序操作，每一步完成后检查节点状态变化：
- 备份工作流：在操作前导出当前 JSON 工作流文件，防止修复过程中配置损坏。
- 安装缺失节点：打开 ComfyUI Manager，点击 "Install Missing Custom Nodes"，系统会自动扫描工作流并列出缺失插件，逐一安装。
- 更新所有节点：在 Manager 界面点击 "Update All"，确保所有自定义节点适配最新核心版本。
- 检查依赖：若节点仍红，查看控制台日志，若提示缺少 Python 库，需在对应虚拟环境中 pip install 安装。
- 版本回退：若更新后仍无法修复，通过 Git checkout 旧版本 ComfyUI 核心或自定义节点。
怎么验证是否生效
验证修复是否成功，需关注界面状态和后台日志：
- 界面检查：所有节点边框颜色恢复正常，不再显示红色警告框。
- 运行测试：点击 Queue Prompt，任务能正常开始执行且进度条不卡死。
- 日志确认：启动控制台无 Python AttributeError 或 ModuleNotFoundError 报错。
常见坑
- Python 环境冲突：不同节点可能依赖不同版本的 torch 或 numpy，混用可能导致隐性报错。
- 模型路径变更：升级后若默认模型目录结构调整，节点虽不红但会因找不到模型文件而运行失败。
- 管理器本身过时：若 ComfyUI Manager 版本过低，可能无法识别新版的节点安装请求，需先更新管理器。
常见问题
节点变红是否还能继续生成？
不能，红色节点表示无法加载或执行，队列任务会直接失败或跳过该节点。
如何保留旧版本 ComfyUI 环境？
建议使用 Git 分支管理或复制整个文件夹备份，不要直接在生产环境覆盖升级。
安装缺失节点后为什么还是红色？
可能需要重启 ComfyUI 服务才能加载新安装的插件，或该节点已废弃不再维护。
参考来源
- ComfyUI Official GitHub: https://github.com/comfyanonymous/ComfyUI
- ComfyUI-Manager GitHub: https://github.com/ltdrdata/ComfyUI-Manager