启动Django服务器时持续出现线程异常错误，请求协助排查

几个实用的排查解决步骤：

• 先查端口是否被占用
  打开命令行执行对应命令，检查默认的8000端口是否被其他程序占用：

  # Windows系统执行
  netstat -ano | findstr :8000
  # macOS/Linux系统执行
  lsof -i :8000
  

  若端口被占用，要么杀掉对应进程，要么换个端口启动服务器：

  python manage.py runserver 8001
  

• 检查虚拟环境配置

  • 确认当前终端已激活项目对应的虚拟环境，避免全局Python包冲突
  • 重新安装项目依赖：

    pip install -r requirements.txt
    

• 核对settings.py配置

  • 检查数据库配置、静态文件路径、INSTALLED_APPS是否正确，尤其是新增应用后有没有添加到INSTALLED_APPS列表
  • 用Django自带命令校验配置：

    python manage.py check
    

• 排查版本兼容性

  • 确认Django与Python版本匹配（比如Django 4.x需要Python 3.8及以上），执行以下命令查看版本：

    python --version
    django-admin --version
    

  • 若存在第三方库冲突，尝试调整依赖版本后重新安装

• 权限问题（仅macOS/Linux）

  • 若使用1024以下端口启动，需添加sudo权限：

    sudo python manage.py runserver 80
    

  • 确认项目目录及文件的读写权限，避免服务器无法访问配置或静态文件

如果以上步骤无效，尝试获取完整的异常栈信息——这个被忽略的线程异常通常会伴随后续错误输出，或者临时修改Django的线程错误捕获逻辑，就能定位到具体引发异常的代码模块。

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