ComfyUI工作流卡在CLIPTextEncode节点是因为text输入未正确连接、未启用“Use text input”开关、节点被设为忽略、CLIP模型未加载或与模型类型不匹配。需检查连接状态、开关启用、Bypass设置、模型兼容性，并通过调试日志和代码插入print语句定位异常。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
ComfyUI工作流执行时，控制台只显示“提示词已记录”却无后续生成动作，节点卡在CLIPTextEncode或相关文本编码环节，导致整个流程停滞不前。
确认提示词节点是否被正确连接
打开工作流JSON，检查CLIPTextEncode节点的输入端口：text字段必须连接来自LoadText、String或KSampler节点的输出，不能悬空或连错端口。悬空会导致节点静默跳过，日志里只写“recorded”却不触发编码。
右键点击CLIPTextEncode节点→选择“View Node Info”，在弹出面板中确认Inputs列表里text项右侧显示绿色对勾；若为灰色叉号，说明未接收到有效输入信号。
常见错误是把prompt字符串直接写进CLIPTextEncode的text框但未启用“Use text input”开关——【必须勾选该复选框，否则节点忽略手动输入】。
检查CLIPTextEncode节点是否被设为“忽略”
双击CLIPTextEncode节点，在参数面板中查找“Bypass”或“Disable”类选项（部分自定义节点如Advanced CLIP Text Encode会提供此功能），确保其处于关闭状态。
若该选项被意外启用，节点将跳过全部计算逻辑，仅在日志中留下“prompt recorded”痕迹，不输出conditioning张量，下游KSampler因缺少条件输入而无法启动采样。
验证模型加载状态与文本编码器兼容性
第一步：在ComfyUI启动日志中搜索“CLIP loaded”或“clip vision”关键词，确认文本编码器模型已成功载入。若无匹配行，说明CLIP权重未加载，节点无法执行编码。
第二步：比对所用checkpoint模型类型（SD1.5 / SDXL / FLUX）与CLIPTextEncode节点版本是否匹配。例如SDXL工作流中使用了基础版CLIPTextEncode（非SDXL专用），会导致编码器拒绝处理长prompt或双token结构——【必须选用标注‘SDXL’或‘Dual CLIPEncode’的节点】。
第三步：临时替换为官方原生CLIPTextEncode节点测试。若原生节点可正常流转，说明问题出在第三方节点实现缺陷，需更新custom_nodes或切换分支。
排查Python层异常捕获静默失败
方法一：启动ComfyUI时添加调试参数 → 在终端执行 python main.py --debug --verbose
方法二：手动触发一次工作流后，立即查看logs/comfyui.log末尾段落，重点寻找包含“CLIPTextEncode”和“Exception”字样的堆栈信息。某些插件会在异常发生时吞掉报错，只留一行“recorded”日志。
方法三：进入comfy_extras/nodes_common.py文件，定位CLIPTextEncode类的encode方法，在return语句前插入print(f"DEBUG: conditioning shape = {cond.shape}")，重启服务观察控制台是否输出实际张量形状。若无输出，说明执行流程在encode入口前已被中断。
