The get_client_ip function has a bug

该报错通常出现在 ComfyUI Desktop 启动阶段,或 ComfyUI-Manager 处理 HTTP 请求并调用 get_client_ip 时。此时如果客户端通过 IPv6 回环地址连入, peername 就可能带有四个值,导致解包失败,进而使 ComfyUI 无法正常启动。优先确认

快速结论:该报错通常出现在 ComfyUI Desktop 启动阶段,或 ComfyUI-Manager 处理 HTTP 请求并调用 get_client_ip 时。此时如果客户端通过 IPv6 回环地址连入,peername 就可能带有四个值,导致解包失败,进而使 ComfyUI 无法正常启动。优先确认 ComfyUI-Manager 版本是否为 4.0.4 及以上。

适用环境:Issue 中出现的报错位置涉及 Python 3.12 的 site-packages/comfyui_manager/__init__.py;用户端为 ComfyUI Desktop。Issue 未提供操作系统、CUDA、PyTorch 或显卡信息。

最快修复方案:升级到已包含修复的 ComfyUI-Manager 4.0.4 或更高版本;该修复由 #2427 合入。

注意事项:另一个变通思路是把 host, port = peername 改为 host, *_ = peername,但这只是社区讨论中的改法,并非该仓库中的正式提交;并且直接修改 site-packages 中的代码会在重装或升级时被覆盖。仍建议以升级到 4.0.4+ 为主。

问题场景

用户运行 ComfyUI Desktop 时无法正常启动。报错定位到 ComfyUI-Manager 的 get_client_ip 函数。该函数通过 request.transport.get_extra_info("peername") 获取客户端地址,再按 host, port = peername 解包。当客户端为 IPv4 地址(如 ('127.0.0.1', 19260))时,解包正常;当客户端为 IPv6 地址(如 ('::1', 28891, 0, 0))时,会触发解包异常,从而导致启动失败。

报错原文

The get_client_ip function has a bug

host, port = peername

too many values to unpack

原因分析

核心原因是 get_client_ip 假定 peername 固定为二元组。实际环境中,IPv4 地址返回 (host, port);IPv6 地址则可能返回包含四个元素的元组,如 ('::1', 28891, 0, 0)。用两个变量解包四个值的元组,就会抛出“too many values to unpack”。这属于地址族差异导致的解包假设错误,并非 ComfyUI 本身或依赖版本冲突。

环境排查

  • 确认 ComfyUI-Manager 的版本:只有当问题仍未解决时,才需继续以下排查。
  • 确认报错文件路径是否指向当前实际安装的 comfyui_manager/__init__.py,Issue 中报告的位置为 env name/lib/python3.12/site-packages/comfyui_manager/__init__.py, line 58。
  • 确认 ComfyUI Desktop 是否存在多个 Python 环境或残留的旧版 comfyui-manager 包,可能导致升级后实际加载的仍是旧代码。
  • 确认启动时的连接地址是否涉及 IPv6 回环地址 ::1;如果是,则更容易触发此路径。
  • Issue 未提供 CUDA、PyTorch、显卡和操作系统信息,因此这些项目不作为本问题的必要排查条件。

解决步骤

  1. 将 ComfyUI-Manager 升级到 4.0.4 或更高版本。#2427 已修复该问题,修复后的逻辑会读取 peername 的前两个值,因此兼容 IPv6 的四元组。
  2. 升级后重启 ComfyUI Desktop,确认启动时不再出现 get_client_ip 相关的 too many values to unpack 报错。
  3. 如果仍出现同一报错,请先检查实际加载的 comfyui_manager/__init__.py 是否来自旧版本或残留环境,避免升级没有真正生效。
  4. 如果确认已升级到当前版本仍能复现,请按维护者要求新建 Issue,并附上报错栈和版本信息;旧 Issue 中未提供其他已验证的修复步骤。

验证方法

重新启动 ComfyUI Desktop,确认启动流程不再因 get_client_ip 抛出的 too many values to unpack 中断;如果先前是通过 IPv6 的 ::1 访问,也应在相同访问方式下验证不再报错。最终应以运行中的实际报错消失为准,不要只凭版本号判断。

参考来源

ltdrdata/ComfyUI-Manager #2375

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36247

发表回复

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