Value not in list：模型已经下载，为什么下拉框仍找不到
运行时 ckpt_name、lora_name 或其他下拉参数不在当前选项中。通常需要检查扫描目录、文件名、正在运行的实例和下拉框旧值，但这个错误也可发生在采样器等非文件选项上。
现象与适用范围
运行时 ckpt_name、lora_name 或其他下拉参数不在当前选项中。通常需要检查扫描目录、文件名、正在运行的实例和下拉框旧值，但这个错误也可发生在采样器等非文件选项上。
检索用原文或片段（具体编号、数值和文件名随环境变化）：
Value not in list
ckpt_name
已核对的依据
官方模型问题页给出 checkpoint 选项触发 Value not in list 的场景。出错字段也可能是非文件选项，因此修改模型文件前应先查看允许值；“列表里没有”不等于“服务器磁盘上绝对没有这个文件”。 D03 D06
需要区分的情况
1. 工作流保存的是另一台机器的相对文件名、子目录或旧名称。
2. 文件下载到错误实例、错误类型目录，或者实际下载的是未完成文件和网页。
3. 核心或节点版本改变了允许选项；当前参数本身不是模型文件字段。
建议的操作顺序
以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。
第 1 步。 查看错误 details 中的输入名与实际允许值；先判断是在选文件，还是在选某个枚举参数。
第 2 步。 在正在运行的实例中定位模型根目录与 extra_model_paths 配置，核对文件类型目录和子目录名称。
第 3 步。 通过界面重新选择当前真实选项，按该版本支持的方式刷新或重启模型扫描；不要只在 JSON 中重命名不存在的文件。
第 4 步。 若列表为空，先解决扫描路径和读取权限；若仅一个文件缺失，检查后缀、完整性和加载器支持，再进行任务验证。
如何判断处理有效
目标文件或选项真实出现在下拉列表，校验不再返回该错误；随后加载成功才证明文件可以读取。
注意事项与尚未确认的部分
选择任意同名近似模型可能导致后续形状不匹配。修改文件名不能让模型家族兼容，也不能修复坏文件。
资料核对日期：2026-09-21。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。
原始资料
- D03 · ComfyUI model troubleshooting。核对：2026-09-21。
- D06 · ComfyUI Portable Windows。核对：2026-09-21。
相关排查与操作
排查下一个可能的原因
同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。
把完整日志粘贴到报错排查工具这篇内容对你有帮助吗？
匿名统计，只记录“有/没有帮助”的计数，不记录账号、IP 地址或设备信息。
资料来源
基于上游文档、源代码或标注为个案的错误报告整理。诊断顺序由本站编排；没有执行、硬件测试或保证修复的结论。
01ComfyUI model troubleshooting资料核对: 2026-09-2102ComfyUI Portable Windows资料核对: 2026-09-21报告问题 · 2e8baa27-1f68-57d0-957e-bfc7c13d01ea
相关阅读
编辑为本页关联的条目。
同一个模型名称可能对应整包 checkpoint、分体权重、量化版、文本编码器和 VAE。此文提供下载记录与核对步骤，避免文章只留一个搜索链接，后来无法确定实际使用哪个文件。
多个 ComfyUI 实例可以按支持的配置引用已有模型目录，但共享文件不代表共享了 Python 环境、节点安装和工作流版本。本页重点解决“模型明明在磁盘上，当前实例却找不到”。