Topic

ComfyUI 常见报错修复合集

把高频报错按现象归类，快速定位原因和解决文章。

有效更新：2026-05-12

这个专题适合谁

适合希望按顺序完成任务，而不是在零散文章之间来回跳转的用户。

完成本专题后，你应该能理解关键概念，完成基础配置，并知道遇到问题时先查哪里。

按下方推荐顺序阅读。每读完一篇，就实际操作一次，并记录遇到的错误关键词。

专题里的文章带有状态和更新时间。后续如果 ComfyUI 或插件大版本变化，可以优先复查专题内文章。

Featured Visuals

降低分辨率、换轻量模型、开启低显存参数是最常用解法。

Step 1

降低分辨率、换轻量模型、开启低显存参数是最常用解法。

Step 2

通常是自定义节点依赖没装，进入对应目录安装 requirements。

Step 3

先看控制台日志，再区分依赖缺失、版本不兼容和路径问题。

Step 4

常见原因是没装 Git、网络拉取失败或目录放错。

Step 5

确认服务是否启动、端口是否被占用、防火墙是否拦截。

Step 6

ComfyUI 主要看 PyTorch 携带的 CUDA 运行时，不一定需要系统 CUDA Toolkit。