CLIP input is invalid: None：加载的 checkpoint 可能没有文本编码器

现象与适用范围

CLIPTextEncode 等节点收到空的 CLIP 输入。需要检查编码器是否真的加载成功、连线是否正确，以及当前模型是否采用分体加载，而不是只看节点框上有没有一根线。

检索用原文或片段（具体编号、数值和文件名随环境变化）：

CLIP input is invalid: None
does not contain a valid CLIP

已核对的依据

ComfyUI v0.37.0 的 CLIPTextEncode 在 clip 输入为 None 时抛出此错误。报错中关于 checkpoint 的提示只适用于输入来自 checkpoint 加载节点的情形；issue #6819 是一个具体报告，不能当作所有情况的诊断结论。基础 SD 工作流可从 checkpoint 获取 CLIP，而 FLUX 分体示例单独加载文本编码器。 D-CLIP I07 D11 D15

需要区分的情况

1. 把只含扩散模型的权重交给预期包含 CLIP 的 checkpoint 加载流程。

2. 编码器节点加载失败、旁路或输出为空，错误最终在下游文本编码节点显现。

3. 使用了与模型家族不匹配的编码器和加载模式，文件虽能选择却不是正确组合。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 从失败节点沿 CLIP 输入向前追踪，记录实际提供编码器的节点类名与文件。

第 2 步。 对照该模型作者示例，确定是整包 checkpoint 还是独立 diffusion/text encoder/VAE 路线。

第 3 步。 分体路线补齐正确编码器及其加载模式，保留模型家族对应关系；不要随意接入另一个 SDXL 或 SD1.5 的 CLIP。

第 4 步。 移除额外 LoRA、IPAdapter 和控制分支，隔离原生文本编码链路。先确认正确加载器输出 CLIP 对象，再考虑提示词内容；修改文字不能修复 None 输入。

如何判断处理有效

编码器节点提供非空有效对象，文本编码与采样都能进入下一阶段；仅把错误换成矩阵维度不符不算完成。

注意事项与尚未确认的部分

CLIP 常用作接口对象名称，并不说明所有模型内部都使用同一种编码器架构。不能通过删除提示词节点绕过必需条件。

原始资料核对日期：2026-09-21；2026-09-25 复核文档、个案和 CLIPTextEncode 源码。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。

原始资料

• D-CLIP · ComfyUI v0.37.0 CLIPTextEncode 源码。核对：2026-09-25。
• I07 · CLIP input is invalid None。原核对：2026-09-21；复核：2026-09-25；个案发表于 2025-02-15。
• D11 · Text-to-image workflow。原核对：2026-09-21；复核：2026-09-25。
• D15 · FLUX.1 native workflows。原核对：2026-09-21；复核：2026-09-25。

相关排查与操作

• FLUX.1 文件与加载器：分体版和 FP8 checkpoint 不能混用
• mat1 and mat2 shapes cannot be multiplied：按模型链路查维度