升级Django至5.0.4后创建项目失败，报AttributeError无DEBUG属性

核心问题分析 #

1. Python版本兼容性问题
   Django 5.0.x 官方仅支持 Python 3.10、3.11、3.12 版本，你使用的 Python 3.13.0a5+ 是预发布的 alpha 版本，Django 尚未适配该版本的内部 API 变化，这是导致初始化报错（AttributeError: 'NoneType' object has no attribute 'DEBUG'）的根本原因。

2. 环境不一致问题
   执行 django-admin 能找到命令，但 python3 -m django 提示模块不存在，说明当前终端的 python3 指向的环境与 django-admin 绑定的环境不一致，大概率是 Python 3.13 环境下 Django 安装不完整或加载失败导致的。

解决步骤 #

• 降级Python到兼容版本
  安装 Python 3.10、3.11 或 3.12（推荐 3.12 稳定版），确保终端默认使用该版本的 Python。

• 重新安装Django
  先卸载现有 Django：

pip uninstall django -y

然后用目标 Python 版本的 pip 重新安装：

python -m pip install django==5.0.4

• 验证并创建项目
  先确认安装成功：

python -m django --version

再执行项目创建命令：

django-admin startproject web_app

报错原因说明 #

Python 3.13 alpha 版本的内部模块加载、信号处理逻辑可能有变更，Django 在初始化缓存模块时，尝试连接 request_finished 信号并读取 settings.DEBUG，但由于版本不兼容导致配置初始化未完成，settings._wrapped 为 None，从而触发 AttributeError。

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