路线总览
不要只复制最后一行报错去搜索。先看错误出现在哪个阶段：启动前、打开页面、导入工作流、点击 Queue，还是更新插件之后。阶段不同，优先入口不同。
| 你的状态 | 先做什么 | 完成标准 |
|---|---|---|
| 页面打不开或 8188 访问失败 | 先看 /guides/port-occupied/ | 知道是服务没启动、端口占用还是地址访问问题 |
| 导入工作流后红色节点 | 先看 /guides/missing-nodes-fix/ | 能用 Manager 安装缺失节点，或判断节点包加载失败 |
| 节点存在但模型名找不到 | 先看 /guides/workflow-model-name-mismatch/ | 能把工作流里的模型名切换成本地已有文件 |
Queue 后 CUDA out of memory | 先看 /guides/cuda-out-of-memory/ | 能降低尺寸、batch、控制分支或模型家族复测 |
| 更新插件后坏掉 | 先看 /guides/comfyui-update-plugin-broken/ | 能识别是插件版本、依赖还是自定义节点导入失败 |
| 控制台出现 Python / CUDA / Torch 关键词 | 再看 no-module-named、custom-nodes-import-failed、torch-cuda-mismatch | 能保存完整 Traceback 并定位依赖层问题 |
第 1 站：先定位失败阶段
同一个红字可能来自不同原因。先回答三个问题：
- ComfyUI 启动窗口还在运行吗？如果没有，先查启动和端口。
- 网页能打开但导入后变红吗？如果是，先查缺节点或插件加载。
- 点击 Queue 才失败吗？如果是，优先查模型路径、显存和工作流参数。
完成标准：你能把问题归到“启动 / 缺节点 / 缺模型 / 显存 / 依赖版本 / 插件更新”其中一类。
第 2 站：按现象进入修复页
| 现象 | 优先入口 | 不要先做什么 |
|---|---|---|
| Missing nodes / 红色节点 | /guides/missing-nodes-fix/ | 不要把模型问题当成节点问题 |
| 工作流要求的模型不存在 | /guides/workflow-model-name-mismatch/ | 不要把所有模型改成作者文件名 |
| Load Checkpoint 为空 | /guides/model-dropdown-empty/ | 不要把模型放进 custom_nodes |
| CUDA OOM | /guides/cuda-out-of-memory/ | 不要先重装 Python 或 CUDA |
No module named ... | /guides/no-module-named/ | 不要随机安装多个 Python |
| 更新后插件坏了 | /guides/comfyui-update-plugin-broken/ | 不要一次更新所有插件再排查 |
常见断点
- 只看网页红字，不看启动窗口里的完整 Traceback。
- 把缺节点、缺模型、模型名不匹配混成一个问题。
- OOM 后先改驱动或 Python，而不是先降低分辨率和 batch。
- 插件安装失败后继续导入复杂工作流，导致错误叠加。
- 没记录刚更新过的插件、ComfyUI 版本和模型文件名。
完成标准
你可以认为自己完成了“报错排查”路线，当且仅当：
- 能保存从
Traceback到最后一行的完整报错。 - 能判断错误属于缺节点、缺模型、插件依赖、显存、端口还是 Torch/CUDA 版本。
- 能按现象进入对应修复页，而不是从头重装。
- 修复后能用同一个最小工作流复测成功。
- 如果仍失败，能带上 ComfyUI 版本、显卡、显存、模型文件名和刚安装的插件继续反馈。
下一步读什么
- 从 0 梳理：
/topics/comfyui-beginner/ - 模型目录和下拉框：
/topics/model-basics/ - 低显存总入口：
/guides/low-vram-optimization/
维护说明
专题里的文章带有状态和更新时间。后续如果 ComfyUI 或插件大版本变化，可以优先复查专题内文章。
