Address already in use:查清占用端口的进程再启动
ComfyUI 启动时无法绑定端口,通常需要区分已有正常实例和其他服务占用。多次双击启动脚本可能制造多个互相冲突的实例,但不能看到端口占用就立即杀掉所有 Python 进程。
现象与适用范围
ComfyUI 启动时无法绑定端口,通常需要区分已有正常实例和其他服务占用。多次双击启动脚本可能制造多个互相冲突的实例,但不能看到端口占用就立即杀掉所有 Python 进程。
检索用原文或片段(具体编号、数值和文件名随环境变化):
Address already in use
EADDRINUSE
Only one usage of each socket address
已核对的依据
操作系统 errno 定义了地址被占用错误。Portable 的启动脚本最终仍然要启动监听进程,因此应以实际进程与监听地址为依据,而不是根据窗口数量判断。 P07 D06
需要区分的情况
1. 已有一个 ComfyUI 实例正常运行,新的启动尝试重复绑定同一端口。
2. 另一个应用、容器映射或后台服务占用了地址。
3. 修改端口后客户端、代理或前端配置仍指向旧地址,产生新的连接问题。
建议的操作顺序
以下顺序是基于上述资料整理的诊断方案,不代表上游已经为你的环境确认了原因。
第 1 步。 用系统工具查看目标端口对应的 PID,再核实该 PID 的程序、路径和用途。
第 2 步。 如果是自己的正常 ComfyUI,直接访问已有服务;确需重启时先保存工作,再正常停止该进程。
第 3 步。 对手动或 Portable 启动的实例,当前 ComfyUI 提供 --port 参数(默认 8188);先核对启动器怎样传入参数,再同步修改浏览器书签、API 与代理入口。5
第 4 步。 再次启动后确认日志显示新地址,避免仍访问另一个实例导致模型和节点列表看似丢失。
可复制的检查命令
Windows PowerShell:
$listeners = Get-NetTCPConnection -LocalPort 8188 -State Listen
$listeners | Select-Object LocalAddress,LocalPort,OwningProcess
$listeners | ForEach-Object { Get-Process -Id $_.OwningProcess | Select-Object Id,ProcessName,Path }
这只是 Windows PowerShell 示例。将 8188 换成启动日志中的目标端口,同时核对本地监听地址;可能出现多条记录。权限不足时进程路径可能为空。没有查到监听记录也不能单凭这一点认定绑定一定能成功,应保留准确的启动错误。34
如何判断处理有效
只有预期实例监听目标地址,访问到的模型、目录和版本与该实例一致。
注意事项与尚未确认的部分
不要对未知 PID 执行强制终止。上面的命令只读,不会停止进程;实际端口应按日志调整。
资料与语言审查日期:2026-09-26。本站未复现端口冲突、结束进程、启动 ComfyUI 或进行 GPU 测试。
原始资料
- P07 · Python errno。复核:2026-09-26。
- D06 · ComfyUI Portable Windows。复核:2026-09-26。
相关排查与操作
排查下一个可能的原因
同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。
- 无法连接 127.0.0.1:8188:先确认服务实际在哪里运行
Connection refused浏览器或脚本无法连接 ComfyUI。localhost 指的是发起访问的那台设备;本机、容器、Notebook、远程服务器和手机之间的地址含义不同,不能只复制一段固定 URL。 - Value not in list:模型已经下载,为什么下拉框仍找不到
Value not in list运行时 ckpt_name、lora_name 或其他下拉参数不在当前选项中。通常需要检查扫描目录、文件名、正在运行的实例和下拉框旧值,但这个错误也可发生在采样器等非文件选项上。
这篇内容对你有帮助吗?
匿名统计,只记录“有/没有帮助”的计数,不记录账号、IP 地址或设备信息。
资料来源
2026-09-26 复核 Python errno、ComfyUI Portable 与 --port 源码,以及 Microsoft Get-NetTCPConnection/Get-Process 文档。本站未复现绑定错误、结束进程、启动 ComfyUI 或进行 GPU 测试。
01Python errno资料核对: 2026-09-2602ComfyUI Portable Windows资料核对: 2026-09-2603Microsoft Get-NetTCPConnection资料核对: 2026-09-2604Microsoft Get-Process资料核对: 2026-09-2605ComfyUI CLI --port source资料核对: 2026-09-26