问题：ComfyUI提示验证失败：CheckpointLoaderSimple值不在列表中

Question

在使用 ComfyUI 进行 Stable Diffusion 模型流程搭建时，用户可能会遇到“验证失败：CheckpointLoaderSimple 值不在列表中”的错误提示。该问题通常发生在节点配置阶段，系统无法识别用户输入的模型名称。常见原因包括模型名称拼写错误、模型未正确加载至配置文件，或 ComfyUI 未扫描到模型文件。解决方法包括检查模型文件是否放置在 models/checkpoints 目录下、重启 ComfyUI 以重新扫描模型，或手动编辑配置文件确保模型路径正确。掌握这一问题的排查逻辑，有助于提升 ComfyUI 使用效率和流程稳定性。

Answer 1

一、问题现象描述

在使用 ComfyUI 搭建 Stable Diffusion 模型流程时，用户可能会在节点配置阶段遇到如下错误提示：

验证失败：CheckpointLoaderSimple 值不在列表中

该提示表明 ComfyUI 在加载 Checkpoint 模型时无法识别用户指定的模型名称，导致节点无法通过校验。

二、常见原因分析

1. 模型名称拼写错误：输入的模型名与实际文件名不一致。
2. 模型未放置在指定目录：未将模型文件放置在 ComfyUI 的 models/checkpoints 目录中。
3. ComfyUI 未扫描到模型文件：模型文件虽已放置正确路径，但未被 ComfyUI 正确加载。
4. 配置文件未更新：ComfyUI 的模型缓存或配置文件未能及时更新。

三、排查流程图

    graph TD
      A[启动 ComfyUI] --> B{是否遇到 CheckpointLoaderSimple 错误}
      B -- 是 --> C[检查模型名称是否拼写正确]
      C --> D{是否匹配现有模型}
      D -- 否 --> E[修改模型名称]
      D -- 是 --> F[检查模型是否在 models/checkpoints 目录]
      F --> G{是否存在}
      G -- 否 --> H[将模型复制到指定目录]
      G -- 是 --> I[重启 ComfyUI]
      I --> J{是否成功加载}
      J -- 否 --> K[手动编辑配置文件]
      J -- 是 --> L[问题解决]
  

四、解决方案详解

步骤	操作说明	验证方法
1. 检查模型名称	确认输入的模型名称与实际文件名完全一致，包括大小写和扩展名。	在 CheckpointLoaderSimple 节点中重新输入模型名称。
2. 模型文件路径	确保模型文件位于 ComfyUI/models/checkpoints/ 目录下。	在文件系统中查看对应路径是否存在模型文件。
3. 重启 ComfyUI	重启应用以触发模型目录的重新扫描。	查看模型列表是否更新。
4. 手动编辑配置文件	修改 ComfyUI/config.json 文件，添加模型路径信息。	保存后重启 ComfyUI，观察是否识别模型。

五、进阶建议与调试技巧

• 启用日志输出：启动 ComfyUI 时添加 --log-level debug 参数，可查看模型加载过程中的详细日志。
• 使用命令行验证模型：可通过 Python 脚本加载模型文件验证其完整性，例如：

from diffusers import StableDiffusionPipeline
pipe = StableDiffusionPipeline.from_pretrained("path/to/model")
pipe.to("cuda")

• 版本兼容性检查：确认模型文件与当前使用的 Stable Diffusion 版本兼容。
• 缓存清理策略：删除 ComfyUI/models/checkpoints/.cache 目录以强制重新生成模型缓存。

六、常见误区与注意事项

以下是一些开发者容易忽略的细节，可能导致该问题反复出现：

• 误将模型文件放置在 models/unet 或 models/vae 目录，而非 checkpoints。
• 未区分模型格式（如 .ckpt 与 .safetensors）导致路径识别失败。
• 未设置正确的文件权限，导致 ComfyUI 无法读取模型文件。
• 使用符号链接或网络路径时未配置 ComfyUI 支持此类路径。