升级Django项目至4.2.3时遇导入错误的解决方法

问题根源 #

Django 4.x版本对应用配置类（AppConfig）的name属性验证逻辑更严格，要求该属性值必须与INSTALLED_APPS中注册的应用路径完全匹配，否则会触发导入错误。

分步解决方案 #

1. 修正应用配置类的name属性 #

找到apps/core/apps.py文件，修改CoreConfig类的name属性：

from django.apps import AppConfig

class CoreConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'  # Django 3.2+强制要求配置此字段
    name = 'apps.core'  # 将原可能的'core'修改为此路径

对changelog应用执行相同操作，修改apps/changelog/apps.py中的ChangelogConfig.name为'apps.changelog'。

2. 确保apps目录为合法Python包 #

在apps目录下创建空的__init__.py文件（若不存在），让Python识别该目录为可导入的包：

.quality/
  apps/
    __init__.py
    core/
    changelog/

3. 验证项目路径配置 #

确保.quality目录在Python路径中。通常Django的manage.py会自动将项目根目录加入路径，若你的manage.py位于.quality目录下，无需额外操作。若路径异常，可在settings.py开头添加：

import sys
from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent
sys.path.append(str(BASE_DIR / 'apps'))

4. 确认INSTALLED_APPS配置正确性 #

保持当前INSTALLED_APPS配置不变即可，因为已同步修改了AppConfig的name属性：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'bootstrapform',
    'apps.core',
    'apps.changelog',   
]

验证修复效果 #

执行以下命令检查项目配置：

python manage.py check

若无报错，启动服务验证：

python manage.py runserver

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