ComfyUI模型存放路径常见问题解析

Question

**问题：ComfyUI加载模型时报错“Model not found”，应如何排查模型存放路径问题？** 在使用ComfyUI时，常出现“Model not found”错误，导致模型无法正常加载。此类问题多由模型存放路径配置不当引起。请解析ComfyUI中模型的标准存放路径结构，说明如何正确放置模型文件（如Checkpoints、Loras、VAE等），并指导如何检查配置文件或界面设置中的路径是否正确，以解决模型加载失败的问题。

Answer 1

一、问题背景与路径结构解析

ComfyUI 是一种基于节点的工作流式图像生成界面，广泛用于Stable Diffusion模型的部署和推理。当用户在加载模型时遇到“Model not found”错误，通常意味着ComfyUI无法在预期路径中找到对应的模型文件。

ComfyUI的模型文件主要包括：

• Checkpoints（主模型）
• Loras（低秩适配模型）
• VAE（变分自编码器）
• CLIP（文本编码器）
• Upscale Models（放大模型）

这些模型应放置在ComfyUI的特定目录结构中。标准路径如下：

模型类型	对应目录
Checkpoints	models/checkpoints/
Loras	models/loras/
VAE	models/vae/
CLIP	models/clip/
Upscale Models	models/upscaling/

二、模型文件放置规范

模型文件应根据类型放置到上述对应目录中。例如：

ComfyUI/models/checkpoints/v1-4.ckpt

ComfyUI/models/loras/add_detail.safetensors

注意：

• 确保文件扩展名正确（如.ckpt、.safetensors）
• 文件名应与模型描述一致，避免拼写错误
• 路径应为绝对路径或相对于ComfyUI启动目录的相对路径

三、检查路径配置的两种方式

ComfyUI的路径配置可通过以下两种方式进行验证：

1. 通过UI界面检查：
   • 启动ComfyUI后，进入“Manage Models”或“Model Loader”节点
   • 查看模型下拉菜单中是否列出了你放置的模型
   • 若未列出，说明路径未被识别或模型未被正确加载
2. 通过配置文件修改路径：
   • 打开ComfyUI/custom_nodes/comfyui-config.json（或主配置文件）
   • 查找model_path或extra_model_paths字段
   • 示例配置如下：

   
   {
       "model_path": "models",
       "extra_model_paths": [
           "/mnt/nvme/models",
           "/media/external_drive/stable_diffusion"
       ]
   }
               

四、路径排查流程图

以下是排查路径问题的Mermaid流程图：

graph TD
            A[开始] --> B{模型文件是否放置在标准目录？}
            B -->|是| C{配置文件路径是否正确？}
            B -->|否| D[将模型移动至对应目录]
            C -->|是| E[重启ComfyUI并尝试加载]
            C -->|否| F[修改配置文件中的路径]
            E --> G{是否仍然报错？}
            G -->|是| H[检查文件权限或扩展名]
            G -->|否| I[问题已解决]

五、常见错误与解决建议

以下是常见的导致“Model not found”的原因及解决建议：

• 路径未被ComfyUI扫描到：添加路径到extra_model_paths配置项
• 文件权限问题：运行chmod 644 model.ckpt确保文件可读
• 缓存问题：删除ComfyUI/models/cache目录并重启
• 跨平台路径问题：在Windows中使用双反斜杠\\或正斜杠/，避免路径错误
• 模型未被正确加载：使用Load Checkpoint节点前确认是否已连接正确路径