CLIP / 文本编码器缺失或配错：双编码器模型只给了一个、SDXL 与 Flux 混淆

Flux + 不正确的 CLIP 配置：在 DualClipLoader 的两个 CLIP 插槽中都使用 t5xxl_fp8_e4m3fn.safetensors
（注：以上为转述文本，非逐字原文。）

现象与触发场景

常见触发场景：

• Flux 工作流在 DualCLIPLoader 的两个插槽里都选了 t5xxl_fp8_e4m3fn.safetensors，漏了 clip_l
• 用 sd_xl_base 的 VAE 或 CLIP 去配 SD1.5/Flux，架构通道数对不上
• 用 Load Checkpoint 去加载一个只含 UNet 的模型（不含 CLIP），却指望它自带文本编码器
• SD3 需要三重编码器（CLIP-L + OpenCLIP bigG + T5-XXL），缺一个就报错

根因

• 不同架构的文本编码器配置完全不同：Flux 使用 16 通道潜空间 + 双文本编码器（CLIP-L + T5-XXL）；SD1.5 走 4 通道 + 单个 CLIP ViT-L/14；SDXL 走 4 通道 + 双编码器（CLIP ViT-L/14 + OpenCLIP ViT-bigG/14）；SD3 走 16 通道 + 三重编码器。少给一个或给错型号都会失败。
• 很多新架构模型（Flux 等）的发布包里就把 UNet、文本编码器、VAE 拆成独立文件，checkpoint 里根本没有 CLIP，必须单独下载并用对应 loader 节点挂上。
• 把编码器文件放错目录（models/clip 与 models/text_encoders 混用）会让节点扫描不到文件，表现为文件不存在。

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

1. 第一步：按架构补齐正确的编码器组合
   Flux 需要两个文件：CLIP-L 用 clip_l.safetensors，T5 用 t5xxl_fp8_e4m3fn.safetensors 或 t5xxl_fp16.safetensors，分别填进 DualCLIPLoader 的两个插槽，绝不能两个槽都填 t5xxl。SDXL 需要 CLIP-L 与 OpenCLIP bigG 两个编码器；SD3 需要三个；SD1.5 只需一个 CLIP ViT-L/14。
2. 第二步：把文本编码器放进正确目录
   文本编码器放 ComfyUI/models/text_encoders/（旧版本目录名为 models/clip/，新版仍兼容）。放好按 R 刷新或重启使其出现在下拉框。ComfyUI 官方配置示例里 text_encoders 支持同时列出新旧两个路径。
   ComfyUI/models/text_encoders/
   comfyui:
   base_path: /path/to/comfyui/
   text_encoders: |
   models/text_encoders/
   models/clip/
3. 第三步：区分「模型自带编码器」与「需要外挂编码器」
   如果用的是完整 checkpoint（如 sd_xl_base_1.0.safetensors），用 Load Checkpoint 就够了，它会自带 CLIP；只有在报 checkpoint 不含 CLIP 时，才改用 Load Checkpoint + 独立 CLIPLoader 组合，或换用完整包含编码器的模型文件。Flux 这类拆分发布的模型则必须走 UNETLoader + DualCLIPLoader + VAELoader 三件套。

验证是否修好

补充说明

官方文档给出的 Flux + 错误 CLIP 配置的正确修法原文为：「在一个插槽中使用 t5xxl_fp8_e4m3fn.safetensors，在另一个插槽中使用 clip_l.safetensors」。社区里还存在“if the clip is from a checkpoint loader node your checkpoint does not contain...”这类中文转述报错，未取得英文逐字原文。

来源

1. [93] （官方文档）　如何排查和解决 ComfyUI 中模型相关的问题 - ComfyUI 官方文档（模型架构不匹配一节）　https://docs.comfy.org/zh/troubleshooting/model-issues
2. [113] （中文社区）　SD-Trainer + ComfyUI 部署指南（AutoDL平台）— Flux 四件套目录结构　https://www.cnblogs.com/HiroMuraki/p/19497023
3. [114] （官方 issue）　Flux 2 Klein models CLIPLoader errors · Issue #11951 · Comfy-Org/Comfy　https://github.com/Comfy-Org/ComfyUI/issues/11951

这条报错里提到的模型文件

下面这些文件名出现在本条报错的原文或解决步骤里（与权重库的文件名精确匹配），站内权重库有对应条目。 要哪个就按「放哪个目录」放好，文件名一字不差（含大小写与扩展名）。

本条报错提到的目录

本条报错的原文或解决步骤里出现了下面这些 models/ 子目录。 权重库里放在这些目录下的文件已按目录列好，可对照确认自己缺的是哪几个。

这条报错要用到的东西

按本条报错所属的类别（模型与权重文件加载）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

同一类别的其他条目

返回报错库