【笔记】部署 AgenticSeek 项目问题：端口 8000 被占用

🚫 部署 AgenticSeek 项目问题二：端口 8000 被占用

💡 问题描述

运行 api.py 时，控制台报错：

ERROR: [Errno 10048] error while attempting to bind on address ('0.0.0.0', 8000): 通常每个套接字地址(协议/网络地址/端口)只允许使用一次。

这表示端口 8000 已被系统中的其他进程占用，导致 Uvicorn 无法正常启动。

---

✅ 解决方法

方法一：查找并终止占用端口的进程

1. 打开命令行，执行：

   netstat -ano | findstr :8000

   输出示例：

   TCP 0.0.0.0:8000 0.0.0.0:0 LISTENING 12345

   说明 PID 为 12345 的进程正在占用端口。

2. 杀掉该进程：

   taskkill /PID 12345 /F

3. 再次运行项目。

---

方法二：修改 AgenticSeek 的端口

如果不想结束其他程序的进程，可以将 AgenticSeek 改为监听其他端口（如 8001）：

1. 打开 api.py

2. 找到类似如下代码（末尾第253行）：

   uvicorn.run(app, host="0.0.0.0", port=8000)

3. 修改为（或其他端口号）：

   uvicorn.run(app, host="0.0.0.0", port=8001)

   

4. 保存后重新运行。

---

📌 注意

• 127.0.0.1:8000 → 是本地地址端口，如果不指定，Uvicorn 默认使用 8000。

• 如果我们经常遇到端口冲突，可以在项目中设置 .env 文件或配置脚本中自动切换空闲端口。