ComfyUI 模型加载失败怎么办：检查路径、文件与工作流

在 ComfyUI 里遇到“找不到模型”“下拉框没有模型”或工作流一运行就报错，先别急着重装。相似的报错可能来自不同环节：模型放错目录、ComfyUI 没有扫描到文件、工作流需要的资源不齐，或者节点配置本身有问题。按报错现象逐步往回查，通常比一次改很多设置更容易定位原因。

先看报错，判断问题大致在哪一层

排查时记下报错文本，并留意失败节点的名称或编号。不要只凭“模型加载失败”这句话判断原因：选择框为空通常意味着扫描或路径问题；模型已经可选、运行时才报错，则应继续检查工作流和节点输入。

第一步：确认模型放进了对应目录

ComfyUI 会按模型用途在不同目录中查找文件。常见目录包括：

不同工作流、模型架构或节点可能使用其他模型类别，例如 diffusion_models、text_encoders。因此，不要把所有文件都放进 checkpoints：先看报错提到的模型类型，再检查对应目录；如果工作流使用了特定节点，也要确认该节点要求的类别和路径。

还要留意是否多套 ComfyUI 安装并存。你可能把文件复制到了一个目录，却启动了另一个目录中的程序。可以先从启动 ComfyUI 的终端或启动脚本确认实际运行位置，再到相应的模型目录核对文件。

第二步：检查文件是否完整、名称是否匹配

文件存在不等于 ComfyUI 一定能使用它。逐项检查：

1. 文件是否下载完成。 对照下载来源提供的文件信息，确认下载没有中断，也没有误把尚未下载完成的临时文件当作模型。
2. 扩展名和实际文件是否相符。 确认文件不是压缩包、网页或错误下载内容，仅仅改名为模型扩展名并不能让它变成可用模型。
3. 文件名是否与工作流记录的名称一致。 某些节点保存了模型名称；如果本地文件改过名，可能出现“某个名称不在列表中”一类提示。可在节点的下拉框中重新选择实际存在的文件。
4. 目录层级是否多套了一层。 例如文件实际位于 models/checkpoints/某个文件夹/模型文件，而你预期它直接位于 models/checkpoints。先确认该模型类别的节点能否扫描到这个位置。

检查后，完全退出并重新启动 ComfyUI，再看模型选择框是否更新。若程序仍看不到文件，继续检查它是否使用了额外模型路径配置。

第三步：核对额外模型路径配置

如果模型放在 ComfyUI 默认目录之外，需要确认运行中的 ComfyUI 确实配置并读取了对应路径。只编辑某个 YAML 文件，并不能保证当前启动方式会使用它；桌面版、便携版或自定义启动脚本的配置位置也可能不同。

配置文件的具体位置和读取方式要以你的安装方式为准。若需要添加路径，先备份原配置，再按 ComfyUI 支持的格式设置。例如，下面展示的是一个路径映射示意，目录名应按本机实际情况调整：

my_models:
  base_path: 'D:/AI/models'
  checkpoints: checkpoints/
  loras: loras/
  vae: vae/
  controlnet: controlnet/

重点核对三件事：base_path 是否指向真实存在的模型根目录；映射的目录名是否对应工作流所用的模型类别；配置文件是否就是当前启动进程读取的文件。配置修改后重启 ComfyUI，并查看启动日志中是否出现额外模型路径相关信息。若使用自定义配置参数启动，也要确认启动参数指向了刚刚编辑的文件。

ComfyUI 官方的故障排查指南也建议先区分核心程序问题和自定义节点问题。遇到不确定的故障时，可把启动方式、报错原文和相关日志一并记录下来，避免只凭界面现象猜测。

第四步：确认工作流需要的资源是否齐全

工作流除了主模型，可能还引用 LoRA、VAE、ControlNet、文本编码器或其他模型文件。打开工作流后，逐个查看带模型选择框的节点：是否有资源未选中、名称无法匹配，或节点提示缺少模型。

可以按这个顺序核对：

1. 找出报错节点，以及它的输入端口和模型选择项。
2. 记录节点期待的资源类型和名称。
3. 检查相应文件是否存在于对应目录，必要时在节点中重新选择。
4. 如果节点本身缺失或无法识别，先确认工作流所需的自定义节点是否已安装并正常加载。

工作流的模型文件与自定义节点是两类不同依赖。缺模型时，通常应检查模型路径和文件；缺节点时，则应处理节点依赖。不要为了修复缺模型而盲目安装一批自定义节点，也不要把缺失节点误判成模型目录问题。

第五步：用最小工作流缩小范围

当原工作流很复杂时，先不要同时改动多个节点。新建一个只包含基础文生图链路的最小工作流，使用一个已确认存在且能在节点列表中选到的检查点模型，连接文本编码、采样、解码和保存图像所需的基础节点，然后运行一次。

结果可以这样判断：

• 最小工作流能运行，原工作流不能： 基础模型路径大概率可用，重点排查原工作流额外引用的资源、节点依赖和连接配置。
• 最小工作流也找不到模型： 优先回到模型目录、文件状态、实际启动位置和额外路径配置。
• 模型可选但运行失败： 查看具体失败节点和完整报错，检查该节点输入及其额外资源，不要只凭模型名称判断。
• 提示节点不存在： 先处理工作流的节点依赖，再继续验证模型链路。

每次只改一个因素，并在修改后重新运行，这样才能知道是哪一步起了作用。直接编辑工作流 JSON 风险较高；若确实需要修改，先备份，再使用能校验 JSON 格式的工具检查。

排查完成后做一次复核

修复后，确认模型能在正确类型的节点中被选中；最小工作流能够完成运行；原工作流所需的其他资源和节点也都已检查。若仍失败，保存完整错误信息、失败节点名称或编号、启动日志，以及模型实际所在目录，再针对具体环节继续排查。这样能把问题从“ComfyUI 加载失败”逐步缩小为路径、文件、资源或节点配置中的一个明确原因。