Django runserver默认8000端口冲突 如何无需手动指定自动分配端口？

方案1：直接启动自动分配空闲端口 #

无需任何额外配置，启动时指定端口为0即可，操作系统会自动分配当前可用的空闲端口：

python manage.py runserver 0

启动后控制台会直接输出实际监听的地址和端口，直接访问即可。

方案2：项目固定端口自动分配（无需手动配置） #

如果希望同一个项目每次启动都优先使用同一个端口，避免每次更换端口需要重新记地址，可以使用启动包装脚本实现：

• 基于项目的绝对路径生成哈希值，映射到10000~60000的高端口区间作为项目默认端口
• 启动前自动检测端口是否被占用，若被占用则自动向后顺延直到找到空闲端口
• 用最终找到的端口启动服务

Linux/Mac 可参考如下脚本，将其命名为drun加入PATH环境变量，赋予可执行权限后，在任意Django项目根目录执行drun即可完成启动：

#!/bin/bash
# 基于项目路径生成唯一基础端口
PROJECT_HASH=$(pwd | md5sum | awk '{print $1}')
BASE_PORT=$(( 10000 + 0x${PROJECT_HASH:0:4} % 50000 ))

# 查找可用端口
PORT=$BASE_PORT
while lsof -Pi :$PORT -sTCP:LISTEN -t >/dev/null ; do
    PORT=$((PORT + 1))
done

echo "Starting Django server at http://127.0.0.1:$PORT"
python manage.py runserver $PORT

Windows 可基于相同逻辑编写PowerShell脚本使用。

方案3：虚拟环境别名简化操作 #

如果你每个项目都使用独立的虚拟环境，可以在虚拟环境的激活脚本中添加别名，进一步简化操作：

• Linux/Mac 环境下修改虚拟环境的bin/activate文件，末尾添加 alias runserver='python manage.py runserver 0'
• Windows 环境下修改虚拟环境的Scripts\activate.bat 或 activate.ps1，添加对应别名
  配置完成后，每次激活项目虚拟环境，直接执行runserver即可自动用空闲端口启动服务。

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