ComfyUI故障排除步骤有哪些

ComfyUI故障排除步骤汇总

1. 启动问题排查（无法启动/闪退）

• 检查Python环境：若启动时报“python丢失”或依赖库错误，需进入ComfyUI安装目录的.venv/Scripts文件夹，打开命令行输入activate激活虚拟环境，再用pip install -r ../../resources/ComfyUI/requirements.txt安装缺失依赖（优先解决numpy、torch等核心依赖）；若虚拟环境无python.exe，需卸载重装ComfyUI。
• 清理冲突插件：若安装插件后无法启动，通过ComfyUI管理器禁用近期安装的插件，或直接删除custom_nodes目录下对应插件文件夹，再重启ComfyUI。
• 重置配置：备份并删除ComfyUI/user/default目录下的配置文件（如comfy.settings.json），恢复默认设置后重启。

2. 插件相关故障（安装失败/导入失败/冲突）

• 安装失败：优先使用ComfyUI管理器安装（国内用户可通过镜像源加速）；若失败，手动下载插件ZIP包，解压至custom_nodes目录（注意文件夹命名与插件名一致），再重启ComfyUI。
• 导入失败：若插件显示“import failed”，需检查插件目录下是否有requirements.txt，打开命令行进入插件目录，运行..\..\..\python\python.exe -m pip install -r requirements.txt安装依赖；或更新ComfyUI及插件至最新版本。
• 插件冲突：若启动时弹出冲突提示，通过日志定位冲突插件（如was-node），进入插件目录删除requirements.txt中冲突的依赖行（如img2texture.git），保存后重启。

3. 节点运行错误（红色节点/报错）

• 红色节点处理：红色描边节点表示输入缺失（如模型、图片未选择），需选中节点重新上传图片（点击“Choose File”）或选择正确模型（如SD1.5/SDXL）。
• 模型版本不匹配：若报错涉及“模型版本不符”（如mat1 and mat2 shapes cannot be multiplied），需确保大模型、LoRA、ControlNet等模型版本一致（推荐使用SD1.5或SDXL系列）。
• 视觉/面部模型缺失：若报错“ClipVision model not found”或“FaceID model is required”，需将对应模型放入models/clip_models（如SD1.5/SDXL的CLIP模型）或models/ipadapter（如IPAdapter的面部特征模型）目录。

4. 性能与兼容性问题

• 内存溢出（Out of Memory）：关闭多余软件释放内存，若仍报错需增加物理内存；或降低工作流分辨率（如将512x512改为256x256）。
• 节点卡顿：若执行图像膨胀（dilation）等操作卡顿，打开ComfyUI-Impact-Pack/impact-pack.ini文件，添加disable_gpu_opencv = True禁用OpenCV GPU加速，保存后重启。
• 版本兼容性：若使用FreeU插件报错“UNetModel'object has no attribute 'default_image_only_indicator'”，需卸载FreeU插件；若OpenCV报错AttributeError: module 'cv2' has no attribute 'setNumThreads'，需更新ComfyUI-Manager至V1.1.2及以上。

5. 日志分析与精准定位

• 查看日志：ComfyUI报错日志位于C:\Users\你的用户名\AppData\Roaming\ComfyUI\logs（Windows）或~/.comfyui/logs（Mac/Linux），重点查看main.log文件（记录核心框架运行日志），搜索“error”关键词定位具体错误。
• 搜索解决方案：将日志中的错误信息（如“RuntimeError: CUDA out of memory”）复制到搜索引擎，添加“ComfyUI”关键词，查找针对性解决方案（如调整batch size、降低模型参数）。