知仓学习社知仓学习社
端口 8188 被占用：Address already in use / 上次的 ComfyUI 进程没退干净 / 全站资源搜索
搜索 更新 2026-10-02
报错 002 安装、启动与运行环境 有来源可查

端口 8188 被占用：Address already in use / 上次的 ComfyUI 进程没退干净

报错原文（原样） 
Traceback (most recent call last):
File "main.py", line 143, in <module>
loop.run_until_complete(start_server(...))
OSError: [Errno 98] Address already in use
（注：以上为转述文本，非逐字原文。）
检索关键词 Address already in use、Errno 98、OSError: [Errno 98] Address already in use、port 8188、8188 端口被占用、启动不了 端口、already in use
先看这一句 启动时终端抛出 Address already in use，浏览器打开 127.0.0.1:8188 显示的是上一次那个旧实例的界面，或者干脆打不开。
适用版本 全版本通用 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

  • 上一次关窗口时后台 python 进程没结束，再次启动
  • 同时开了两个 ComfyUI（便携版 + 桌面版）
  • 别的软件占用了 8188

根因

  • 服务端在 127.0.0.1:8188 上 bind 时该地址已被占用，Python 的 socket 层直接抛 OSError [Errno 98]（Linux/macOS 与 Windows 便携版终端里的同义报法）
  • 关闭启动窗口不等于进程结束，残留的 python.exe 仍持有着监听套接字；桌面版则以退出码 3221225477 之类形式表现为启动失败
  • 旧实例与手动启动的实例叠加后，端口被先启动的那个一直占着

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 查清是谁占着 8188 并结束它
    用 netstat 找到监听 8188 的 PID，再从任务管理器或 taskkill 结束该进程。Windows 上常见的就是残留的 python.exe。
    netstat -ano | findstr :8188
    taskkill /PID <上一步查到的PID> /F
  2. 临时换一个端口启动
    如果不想杀进程，或占用者是别的软件，用 --port 换端口启动（官方故障排除页也建议默认 8188 被占时改用 8189 / 8190）。
    .\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --port 8189
  3. 桌面版被写坏配置时，重置配置文件
    桌面版把端口/监听地址写在 Documents\ComfyUI\user\default\comfy.settings.json 里，改错这一项会导致应用此后一直启动失败。把它备份后删除，重启应用会自动生成默认配置。

验证是否修好

终端出现 To see the GUI go to: http://127.0.0.1:8188（或新端口）且不再抛 Address already in use；任务管理器里只有一个 python 进程在跑 ComfyUI。

补充说明

error_text 为按真实报错结构复写的通用 Python socket 报错（本条目在官方 issue 标题中得到确认，但本次未能直连 GitHub 取到 issue 正文原文），故 error_text_verbatim 标为 false。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [4] （官方 issue）　[Errno 48] error while attempting to bind on address ('127.0.0.1', 818　https://github.com/Comfy-Org/ComfyUI/issues/1579
  2. [5] （社区）　ComfyUI-Stuck-Process-Killer: A simple script to kill stuck ComfyUI pr　https://github.com/Zuowa111/ComfyUI-Stuck-Process-Killer
  3. [6] （官方文档）　How to Troubleshoot and Solve ComfyUI Issues - ComfyUI　https://docs.comfy.org/troubleshooting/overview
  4. [7] （官方论坛）　Comfy won't start - No Available Ports　https://forum.comfy.org/t/comfy-wont-start-no-available-ports/1225

这条报错要用到的东西

按本条报错所属的类别（安装、启动与运行环境）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

环境与依赖配置包依赖版本组合清单 / 环境自检脚本说明 待挂载
节点库装扩展之后出问题的，多半是节点依赖没装全 板块

同一类别的其他条目

【001】双击 run_nvidia_gpu.bat 窗口一闪而过：c10.dll 缺失，需要安装 VC++ 运行库 有来源 【003】torch 加载失败：OSError [WinError 1114] 动态链接库(DLL)初始化例程失败 c10.dll 有来源 【004】便携版找不到内嵌 Python / 路径不对：'python' 不是内部或外部命令、系统找不到指定的路径 有来源 【005】用户名/路径含非 ASCII 字符或空格导致安装与启动失败 有来源 【006】Torch not compiled with CUDA enabled：装的是 CPU 版 torch 或 torch 与驱动不匹配 有来源
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库