ComfyUI更新后要注意什么

ComfyUI更新后的注意事项与操作清单
一 升级前的准备

• 备份关键数据：优先备份你的工作流 JSON、自定义节点目录custom_nodes/、模型与输出目录，以及当前的requirements.txt或环境快照，便于快速回滚。
• 评估节点维护状态：不少第三方节点并非官方维护，升级后常因依赖（如torch/transformers）版本不匹配而报错；若节点已停更，建议暂不升级或寻找替代。
• 使用虚拟环境：确保在一个干净的conda/venv中操作，避免不同节点间的依赖互相污染，出现问题时也便于重建。
• 谨慎使用管理器自动装依赖：管理器可能无提示升级依赖，破坏现有环境；如无把握，尽量手动控制依赖版本与安装过程。

二 升级中的关键检查

• 同步更新自定义节点：主程序升级后，诸如Advanced-ControlNet等深度依赖核心API的节点需同步更新，否则易出现如KSampler 执行错误等连锁问题。
• 核对配置文件位置与格式：自0.4.55+起，桌面版将配置文件重定向到系统目录（如 Windows 的C:Users<用户名>AppDataLocalPrograms@comfyorgcomfyui-electronresourcesComfyUIextra_model_paths.yaml），在原安装目录修改已不生效；共享 Stable Diffusion WebUI 模型需按新位置与规范配置。
• 避免依赖漂移：升级时可能拉取最新的torch/transformers等，和既有节点产生不兼容；必要时固定版本或回退节点。
• 前端与API变更：前端与API迭代较快，升级后留意控制台报错与工作流节点兼容性提示，必要时参考更新说明逐项核对。

三 升级后的快速自检

• 逐个启用节点：先禁用全部自定义节点，确认核心能跑；再逐个启用定位问题节点，减少一次性冲突排查成本。
• 常见症状与处理：
• 节点输入/输出图形不显示、连线残留：多为前端渲染不兼容，优先更新该节点或临时移出。
• 工作流拖动卡顿/界面无响应：可能是节点的执行逻辑循环或事件冲突，更新或禁用相关节点。
• 页面一直转圈无法进入：某启动脚本/依赖损坏或兼容性异常，更新该节点或在安全模式下移除。
• 报错“cannot read properties of undefined (reading 'befo…”)：典型的节点前端与本体版本不匹配，更新对应节点或回退本体。
• 模型路径与加载：若使用extra_model_paths.yaml共享模型，确认新路径已生效、大小写与绝对路径正确，并重启生效。

四 回退与长期策略

• 快速回退方案：
• Git 方式：在 ComfyUI 根目录执行git reset --hard后git pull origin master，再执行pip install -r requirements.txt恢复依赖；必要时用备份的requirements.txt或环境快照还原。
• 桌面版：优先使用内置的一键升级/回退能力，减少手工改动风险。
• 长期维护建议：
• 控制节点数量与依赖复杂度，优先选择仍在维护且已适配新版本的节点。
• 采用“小步升级、逐项验证”的节奏，升级后立即验证核心工作流与关键节点。
• 关注Nodes v3路线：官方正推进公共 API、节点独立进程与UI联动等改进，未来升级将更强调接口稳定与解耦，节点生态也会逐步向新规范迁移。