Django执行python manage.py runserver时系统检查阶段无报错退出

问题重现 #

执行python manage.py runserver后，输出停留在Performing system checks...阶段，无任何错误提示直接返回命令行：

C:\Users\Destiny Franks\Desktop\ecommerce_prj>python manage.py runserver
Watching for file changes with StatReloader
Performing system checks...


C:\Users\pc-name\Desktop\ecommerce_prj>python manage.py runserver
Watching for file changes with StatReloader
Performing system checks...

C:\Users\pc-name\Desktop\ecommerce_prj>

排查步骤 #

1. 单独执行系统检查命令 #

绕过runserver直接运行系统检查，大概率能暴露隐藏的错误：

python manage.py check

这条命令会单独触发所有系统检查逻辑，若存在崩溃点，会直接输出错误堆栈信息。

2. 排查自定义上下文处理器 #

你的settings.py中配置了自定义上下文处理器core.context_processor.default，这类全局处理器在系统检查阶段会被初始化执行，一旦内部有错误（比如语法问题、数据库查询失败、依赖缺失），可能导致无提示崩溃：

• 临时注释掉TEMPLATES配置中的该上下文处理器，再运行runserver测试。
• 如果能正常启动，就去检查core/context_processors.py中的default函数，逐行排查逻辑错误。

3. 逐个排查第三方应用冲突 #

项目引入了大量第三方应用，部分应用的初始化逻辑可能与Django 3.2.7不兼容，或依赖缺失：

• 临时注释掉INSTALLED_APPS中的非核心第三方应用（比如jazzmin、django_ckeditor_5、geoip2、django_user_agents、anymail等），只保留Django自带核心应用和你的自定义应用。
• 若能正常启动，再逐个恢复第三方应用，每次恢复后运行runserver，定位到导致崩溃的具体应用。

4. 检查GeoIP2配置 #

settings.py中设置了GEOIP_PATH = os.path.join('geoip')，需确认：

• 项目根目录下是否存在geoip文件夹？
• 文件夹内是否有GeoIP2的数据库文件（比如GeoLite2-City.mmdb）？
  如果目录不存在或文件缺失，geoip2初始化会崩溃且可能无提示。可以临时注释geoip2应用和相关配置，测试是否能启动。

5. 检查CKEditor 5配置 #

django_ckeditor_5的配置可能存在语法错误，或版本与Django 3.2不兼容：

• 临时注释INSTALLED_APPS中的django_ckeditor_5和settings.py中的CKEDITOR_5_CONFIGS配置块，测试启动情况。

6. 启用Django日志捕获隐藏错误 #

添加日志配置到settings.py，让崩溃时的错误信息输出到文件：

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'file': {
            'level': 'DEBUG',
            'class': 'logging.FileHandler',
            'filename': 'django_error.log',
        },
    },
    'loggers': {
        'django': {
            'handlers': ['file'],
            'level': 'DEBUG',
            'propagate': True,
        },
    },
}

运行runserver后，查看生成的django_error.log文件，里面会记录崩溃的详细堆栈信息。

7. 验证Python环境与依赖 #

• 最近是否更新过依赖包？尝试创建全新虚拟环境，重新安装所有依赖：

  python -m venv new_env
  # 激活虚拟环境（Windows）
  new_env\Scripts\activate
  pip install -r requirements.txt
  

  然后测试启动。

8. 检查SQLite数据库完整性 #

若SQLite数据库文件db.sqlite3损坏，也可能导致系统检查阶段崩溃：

• 备份当前db.sqlite3，然后删除原文件，执行python manage.py migrate重新生成数据库，再测试启动。

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