Django服务器无法重启：默认端口重复启动失败求助

1. 清理占用端口的残留进程 #

Debian下可以用以下命令排查并杀掉占用8000端口的进程：

• 查找端口进程：

  lsof -i :8000
  

  或者用netstat：

  netstat -tulpn | grep :8000
  

• 杀掉对应进程（替换<PID>为查到的进程ID）：

  kill -9 <PID>
  

  如果是Django相关的Python进程，也可以批量清理：

  pkill -f "python manage.py runserver"
  

2. 修正PyCharm运行配置 #

• 打开PyCharm的「Run/Debug Configurations」，找到你的Django运行配置：
  • 确保「Port」设置为8000，无强制使用其他端口的选项；
  • 勾选「Single instance only」，避免同时启动多个服务器实例；
  • 停止服务器时，点击运行面板的红色停止按钮，不要直接关闭终端窗口，确保进程彻底终止。

3. 禁用Django自动重载（临时解决） #

如果是自动重载机制导致的僵尸进程残留，启动服务器时添加--noreload参数：

python manage.py runserver --noreload

这样关闭服务器时，进程会直接退出，不会遗留占用端口的子进程。

4. 规范服务器终止流程 #

每次停止服务器必须使用Ctrl+C在终端中正常终止，不要直接关闭终端或强制结束窗口，避免Django无法释放端口资源。

内容的提问来源于stack exchange，提问作者Zesshi