1. 问题现象与背景解析
最近在ComfyUI中使用Flux模型时,不少用户遇到了一个典型的报错:KeyError: 't5xxl'。这个错误通常发生在CLIPTextEncodeFlux节点执行过程中,系统提示无法访问T5XXL编码器的输出。作为一个长期使用Stable Diffusion生态的开发者,我可以明确告诉大家:这完全是一个配置问题,不会对模型文件造成任何损坏风险。
Flux模型作为Stable Diffusion生态中的新成员,其工作流程需要同时加载两个CLIP模型:标准的CLIP-L和T5XXL。这种双模型架构带来了更强的文本理解能力,但也增加了配置复杂度。根据我的实测统计,90%以上的t5xxl报错都是由于DualCLIPLoader节点的参数设置不当导致的。
重要提示:如果你看到这个错误,首先应该感到庆幸——因为这意味着你的模型文件基本完好,只需要调整几个配置参数就能解决问题。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 错误排查与解决方案
2.1 第一步:检查DualCLIPLoader配置
这是最关键的一步,也是大多数错误的根源所在。打开你的工作流JSON文件,找到DualCLIPLoader节点的配置部分。正确的配置应该如下所示:
json复制"widgets_values": [
"clip_l.safetensors",
"t5xxl_fp16.safetensors",
"flux",
"default"
]
特别注意第三个参数必须严格设置为"flux"。我在社区看到过太多案例是因为这里误设为sdxl或default导致的错误。这个参数告诉加载器使用Flux专用的模型处理方式。
2.2 第二步:验证模型文件完整性
确认以下两个模型文件已正确放置在指定目录,且文件名完全匹配:
ComfyUI/models/clip/clip_l.safetensors(约3.2GB)ComfyUI/models/clip/t5xxl_fp16.safetensors(约9.6GB)
常见问题包括:
- 文件下载不完整(检查文件大小)
- 文件名被修改(必须保持原始名称)
- 存放路径错误(必须在clip子目录下)
如果发现文件缺失,建议从Ci
