AttributeError: ‘tuple’ object has no attribute ‘encode’

该报错出现在 ComfyUI 执行 FaceDetailer 节点时,Impact Pack 的图像编码环节把非图像对象传给了 VAE,导致 vae.encode(pixels) 抛出 AttributeError: 'tuple' object has no attribute 'encode'

快速结论:该报错出现在 ComfyUI 执行 FaceDetailer 节点时,Impact Pack 的图像编码环节把非图像对象传给了 VAE,导致 vae.encode(pixels) 抛出 AttributeError: 'tuple' object has no attribute 'encode'。应优先检查 FaceDetailer 的图像输入类型以及相关节点/插件是否改写了节点执行逻辑。

适用环境:Windows(OS: nt);ComfyUI 0.3.59;Python 3.11.5;PyTorch 2.8.0+cu126;NVIDIA GeForce RTX 3050(cuda:0);启动参数 --lowvram --auto-launch;同时安装了 comfyui-lora-manager、RES4LYF、rgthree-comfy、SeargeSDXL、OpenPose Editor、taesd 等自定义节点。

最快修复方案:暂无确认的一步修复方案。

注意事项:Issue 讨论中未给出已验证的根因与修复步骤。堆栈显示 comfyui-lora-manager 的 metadata_hook 介入节点执行,但这只能说明该插件可能参与调用链,不能直接证明它是根因;同样不能排除输入连线错误、其他自定义节点改写输出类型或 Impact Pack 相关代码兼容性问题。在未复现验证前,不要仅凭堆栈删除插件或改动核心代码。

问题场景

用户在 ComfyUI 中运行包含 FaceDetailer 节点(Node ID 126)的工作流时触发异常。堆栈依次经过 Impact Pack 的 FaceDetailer.enhance_face、DetailerForEach.do_detail、core.enhance_detail,最后在 ComfyUI 原生 nodes.py 的 encode 函数中执行 vae.encode(pixels) 时失败。报错发生在图像编码阶段,而非模型加载阶段。

报错原文

AttributeError: 'tuple' object has no attribute 'encode'
File "C:\REAL COMFYUI\ComfyUI\custom_nodes\comfyui-impact-pack\modules\impact\impact_pack.py", line 876, in doit
    enhanced_img, cropped_enhanced, cropped_enhanced_alpha, mask, cnet_pil_list = FaceDetailer.enhance_face(
File "C:\REAL COMFYUI\ComfyUI\custom_nodes\comfyui-impact-pack\modules\impact\impact_pack.py", line 830, in enhance_face
    DetailerForEach.do_detail(image, segs, model, clip, vae, guide_size, guide_size_for_bbox, max_size, seed, steps, cfg,
File "C:\REAL COMFYUI\ComfyUI\custom_nodes\comfyui-impact-pack\modules\impact\impact_pack.py", line 362, in do_detail
    enhanced_image, cnet_pils = core.enhance_detail(cropped_image, model, clip, vae, guide_size, guide_size_for_bbox, max_size,
File "C:\REAL COMFYUI\ComfyUI\custom_nodes\comfyui-impact-pack\modules\impact\core.py", line 346, in enhance_detail
    positive, negative, latent_image = imc_encode(positive, negative, upscaled_image, vae, mask=noise_mask, noise_mask=True)
File "C:\REAL COMFYUI\ComfyUI\nodes.py", line 439, in encode
    concat_latent = vae.encode(pixels)

原因分析

从堆栈看,异常并不来自 FaceDetailer 的参数解析,而是最终传入 vae.encode(pixels) 的 pixels 被当成了 tuple 使用,说明该位置期望的是图像像素张量,实际拿到的对象类型不符。

可能原因包括:

  • FaceDetailer 的图像输入链路中存在类型不匹配,例如上游节点输出的是 tuple 而非 IMAGE;
  • 某些自定义节点包装或改写了节点执行逻辑,导致传给 Impact Pack 编码流程的对象结构发生变化;
  • comfyui-lora-manager 的 metadata_hook 出现在调用链中,它可能影响执行时的输入/输出处理,但 Issue 中没有进一步验证;
  • Impact Pack 与当前 ComfyUI 0.3.59 的兼容性问题,但 Issue 未确认。

环境排查

  • 确认 ComfyUI 版本为 0.3.59,与 Issue 环境一致,避免混入其他版本行为差异。
  • 确认 Python 3.11.5、PyTorch 2.8.0+cu126 环境是否与 ComfyUI 及 Impact Pack 兼容。
  • 检查 FaceDetailer 节点的 image 输入来源,确认上游节点输出的是标准 IMAGE 类型,而不是 tuple 或其他复合结构。
  • 检查是否安装了 comfyui-lora-manager,并确认其 metadata_hook 是否参与当前工作流执行。
  • 检查其他自定义节点(RES4LYF、rgthree-comfy、SeargeSDXL、OpenPose Editor、taesd)是否存在版本冲突或被加载失败的情况。
  • 查看启动日志中是否出现自定义节点导入错误或依赖缺失,排除因插件加载异常导致的执行行为变化。

解决步骤

  1. 先以最小工作流复现:使用 FaceDetailer 节点,接入标准的 Load Image → FaceDetailer 流程,排除复杂工作流中其他节点导致类型传递异常的可能。
  2. 检查 FaceDetailer 的 image 输入连接。如果上游节点输出的不是 IMAGE,请改为使用标准图像输出节点;如果使用了自定义图像处理节点,暂时绕过它再测试。
  3. 可优先尝试临时禁用 comfyui-lora-manager,重启 ComfyUI 后再次运行相同工作流,观察报错是否消失,以判断 metadata_hook 是否影响执行链。
  4. 可优先尝试禁用其他非必要自定义节点(尤其是会改写节点执行、输出包装或输入校验的插件),逐步启用并复测,缩小冲突范围。
  5. 确认 Impact Pack 与 ComfyUI 均为较新且相互兼容的版本。Issue 未提供更新或回退后解决的确切证据,因此此步骤属于排查手段而非确认修复。
  6. 如果最小工作流仍然报错,请保留完整堆栈、工作流截图和自定义节点列表,到 Impact Pack 仓库重新反馈,便于维护者根据具体节点输入定位问题。

验证方法

在完成上述排查后,重新运行包含 FaceDetailer 的工作流。如果不再出现 AttributeError: 'tuple' object has no attribute 'encode',且 FaceDetailer 能正常输出增强图像,说明问题已解决或已被规避。若最小工作流仍复现,则说明问题不在复杂节点连线,可能涉及插件冲突或版本兼容性,需要进一步反馈。

参考来源

ltdrdata/ComfyUI-Impact-Pack #1111

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36507

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注