ComfyUI中ControlNet模型应放在哪个文件夹？

Question

在使用ComfyUI时，许多用户常遇到ControlNet模型加载失败的问题，其根本原因多为模型存放路径错误。那么，ControlNet模型应放在哪个文件夹？正确路径应为 `ComfyUI/models/controlnet/` 目录下。若将模型文件（如 `control_net_depth.safetensors` 等）放入此文件夹，ComfyUI才能在节点中正确识别并加载对应模型。若放置在其他目录（如 `models/checkpoints` 或 `models/clips`），即使重启界面也无法显示。此外，确保文件格式完整、命名规范，避免中文或特殊字符。该问题虽小，却直接影响工作流构建，是初学者配置ControlNet时常犯的关键配置错误之一。

Answer 1

ComfyUI中ControlNet模型加载失败的深度解析与系统性解决方案

1. 问题现象：ControlNet模型无法在节点中显示

许多用户在使用ComfyUI构建图像生成工作流时，尝试添加ControlNet节点后发现目标模型（如control_net_depth.safetensors、canny或openpose）未出现在下拉列表中。即使确认已下载模型文件，重启ComfyUI界面也无济于事。

该问题普遍存在于初学者和部分中级用户中，常被误判为“软件Bug”或“版本不兼容”，实则多源于配置路径错误。

2. 根本原因分析：模型存放路径不正确

ComfyUI采用模块化模型管理机制，不同类型的模型必须存放在指定目录下才能被自动扫描并注册到运行时环境中。ControlNet模型有其专用目录：

• 正确路径：ComfyUI/models/controlnet/
• 错误路径示例：
  • ComfyUI/models/checkpoints/（用于主扩散模型）
  • ComfyUI/models/clips/（用于CLIP编码器）
  • ComfyUI/models/loras/（LoRA适配器专用）

若将ControlNet模型放入上述非对应目录，即便文件完整也无法被加载器识别。

3. 正确的模型放置流程

1. 确认已从可信来源（如Hugging Face或Civitai）下载ControlNet模型文件
2. 检查文件扩展名是否为.safetensors或.ckpt（推荐前者）
3. 打开本地ComfyUI安装目录
4. 进入子目录：models/controlnet/
5. 将模型文件复制至此目录
6. 确保文件名不含中文、空格或特殊字符（如[v2].safetensors建议改为v2.safetensors）
7. 重启ComfyUI服务进程
8. 在前端界面创建“Load ControlNet Model”节点
9. 点击模型选择下拉框，应可见新添加的模型名称
10. 连接至后续节点完成工作流构建

4. 常见错误与排查清单

错误类型	具体表现	解决方案
路径错误	模型未出现在节点选项中	移动至models/controlnet/
命名不规范	日志报错“model not found”	重命名为英文+下划线格式
文件损坏	加载时报“invalid tensor”	重新下载或校验SHA256
权限不足	无法读取文件内容	检查文件读取权限（Linux/Unix系统）
缓存残留	旧模型仍显示	清除浏览器缓存或重启服务

5. 高级调试方法：日志分析与API验证

当模型仍未加载时，可通过以下方式深入诊断：

# 启动ComfyUI时观察控制台输出
python main.py --listen 0.0.0.0 --port 8188

# 查看是否包含如下成功加载日志：
[INFO] Found controlnet model: control_net_depth.safetensors
[INFO] Loading ControlNet model from ./models/controlnet/control_net_depth.safetensors

若出现File not found或Unsupported format，说明路径或格式存在问题。

6. 架构视角：ComfyUI模型加载机制解析

从系统架构角度看，ComfyUI通过folder_names.py定义了各模型类型的搜索路径映射：

# comfy.utils.folder_names.FOLDER_NAMES
FOLDER_NAMES = {
    "checkpoints": "models/checkpoints/",
    "controlnet": "models/controlnet/",
    "loras": "models/loras/",
    "vae": "models/vae/"
}

所有节点在初始化时会调用get_filename_list("controlnet")来获取可用模型列表，该函数依赖预设路径进行文件枚举。

7. 可视化流程图：ControlNet模型加载全路径

graph TD
            A[用户下载ControlNet模型] --> B{检查文件完整性}
            B -->|是| C[复制至models/controlnet/]
            B -->|否| D[重新下载]
            C --> E[启动ComfyUI服务]
            E --> F[系统扫描controlnet目录]
            F --> G{发现有效.safetensors文件?}
            G -->|是| H[注册模型至节点库]
            G -->|否| I[记录警告日志]
            H --> J[前端节点可选择该模型]
            I --> K[提示用户检查路径与格式]

8. 最佳实践建议

• 建立标准化模型管理目录结构
• 使用脚本自动化模型归类（如Python脚本按扩展名分类）
• 定期清理重复或废弃模型以减少加载开销
• 在团队协作环境中统一路径规范，避免跨平台差异
• 结合Git LFS或NAS存储实现模型版本控制
• 启用ComfyUI Manager插件以可视化管理模型依赖
• 对关键模型做哈希值备案，防止意外篡改
• 开发自定义节点前先验证基础模型加载能力