快速结论:该报错通常出现在 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、显卡和操作系统信息,因此这些项目不作为本问题的必要排查条件。
解决步骤
- 将 ComfyUI-Manager 升级到 4.0.4 或更高版本。#2427 已修复该问题,修复后的逻辑会读取
peername的前两个值,因此兼容 IPv6 的四元组。 - 升级后重启 ComfyUI Desktop,确认启动时不再出现
get_client_ip相关的too many values to unpack报错。 - 如果仍出现同一报错,请先检查实际加载的
comfyui_manager/__init__.py是否来自旧版本或残留环境,避免升级没有真正生效。 - 如果确认已升级到当前版本仍能复现,请按维护者要求新建 Issue,并附上报错栈和版本信息;旧 Issue 中未提供其他已验证的修复步骤。
验证方法
重新启动 ComfyUI Desktop,确认启动流程不再因 get_client_ip 抛出的 too many values to unpack 中断;如果先前是通过 IPv6 的 ::1 访问,也应在相同访问方式下验证不再报错。最终应以运行中的实际报错消失为准,不要只凭版本号判断。
参考来源
ltdrdata/ComfyUI-Manager #2375
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。

![OSError: [Errno 22] Invalid argument on Windows when flushing stderr](https://www.chat-gpts.plus/wp-content/uploads/2026/11/2458-1ad8a6de-768x403.jpg)
![[Feature]: Let the Bedrock guardrail screen tool-call arguments](https://www.chat-gpts.plus/wp-content/uploads/2026/11/46454-22c3ca41-768x403.jpg)