根本原因是模型路径、类型、存放位置三者不匹配；需检查JSON中引用的模型名，核对是否存在于对应models子目录，按后缀和用途归类存放，避免误放checkpoints，并通过日志定位下载链接、镜像加速下载、手动指定路径或验证文件完整性来修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
LiblibAI上导出的ComfyUI工作流在本地加载时卡在“正在加载模型”或节点报红，根本原因是模型路径、类型、存放位置三者不匹配，而不是网络慢或软件卡死。
先确认模型是否真的缺失
打开工作流JSON文件，用文本编辑器搜索"model_name"或"unet_name"等字段，记下所有被引用的模型文件名（如flux1-fp8-dev.safetensors、t5xxl_fp8_e4m3fn.safetensors）。
进入你的ComfyUI根目录 → models → 逐个检查对应子文件夹：unet、clip、vae、loras，看这些文件是否真实存在且大小不为0字节。
如果文件存在但节点仍报红，说明【模型类型与文件夹不匹配】——例如把LoRA模型误放进了checkpoints，或把T5文本编码器放在了unet里。
手动补全缺失模型的完整路径
第一步：打开C:\Users\{你的用户名}\AppData\Roaming\ComfyUI\logs\main.log，滚动到底部，查找含Starting download的行。
第二步：复制日志中出现的原始Hugging Face下载链接，把huggingface.co替换成hf-mirror.com，粘贴进浏览器下载。
第三步：根据文件名后缀和用途，精准放入对应文件夹：
• .safetensors结尾且含unet或flux字样 → 放入models\unet
• t5xxl_*或clip_l.safetensors → 放入models\clip
• ae.safetensors → 放入models\vae
• *lora*.safetensors → 放入models\loras
注意：不要把所有模型都扔进checkpoints——这个文件夹只收完整底模（如realisticVision.safetensors），其他类型放错就永远加载失败。
修复模型类型识别错误
方法一：直接改文件夹位置
如果节点报错是CheckpointLoaderSimple ERROR: Could not detect model type of xxx.safetensors，大概率是模型类型判断失误。把该文件从checkpoints移出，按实际类型放进unet、loras等对应目录，重启ComfyUI即可。
方法二：强制指定模型路径
在工作流中找到报错的加载节点（如CheckpointLoaderSimple或LoraLoader），双击打开参数面板，点击模型下拉框右侧的文件夹图标→手动导航到你已放好的正确路径，选中文件并确认。这一步绕过自动扫描，强制绑定。
方法三：检查文件完整性
用Windows资源管理器右键该模型文件 → 属性 → 详细信息，查看“文件大小”。若显示为0字节或远小于官网标注大小（如标称4.89GB却只有2KB），说明下载中断或镜像站返回了错误响应，必须重新下载。
