跳至正文
ComfyUI WorldBETA
登录
资料整理

Address already in use:查清占用端口的进程再启动

ComfyUI 启动时无法绑定端口,通常需要区分已有正常实例和其他服务占用。多次双击启动脚本可能制造多个互相冲突的实例,但不能看到端口占用就立即杀掉所有 Python 进程。

更新于 2026-09-25发布修订: 7资料基线: 7

现象与适用范围

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 测试。

原始资料

相关排查与操作

还没解决?

排查下一个可能的原因

同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。

  1. 无法连接 127.0.0.1:8188:先确认服务实际在哪里运行Connection refused浏览器或脚本无法连接 ComfyUI。localhost 指的是发起访问的那台设备;本机、容器、Notebook、远程服务器和手机之间的地址含义不同,不能只复制一段固定 URL。
  2. 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

报告问题 · 635a8c7f-4f47-55cc-b2ee-60a6717a5070