Django 4.1执行测试时报错：找不到'django.config'模块

可能原因及排查步骤 #

1. 确认settings模块指定是否正确 #

打开项目根目录下的manage.py，检查开头的环境变量设置代码：

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings')

确保此处填写的是'config.settings'而非'django.config.settings'——后者会直接导致Django尝试查找不存在的django.config模块。

2. 清理Python字节码缓存 #

残留的缓存文件可能导致导入逻辑混乱，执行以下命令删除所有__pycache__目录：

find . -name "__pycache__" -type d -exec rm -rf {} +

3. 排查隐性错误导入 #

重点检查以下文件是否存在误写的导入语句：

• config/settings.py：查找是否有from django.config import ...这类错误引用
• config/__init__.py：若该文件存在，确认内部导入内容无异常
• 自定义管理命令、中间件文件：排查是否有错误指向django.config的代码

4. 验证INSTALLED_APPS配置 #

打开config/settings.py，检查INSTALLED_APPS列表，确保没有误添加'django.config'这类无效条目。

5. 确认测试命令的运行上下文 #

必须在项目根目录下执行测试命令：

python manage.py test

在子目录运行可能触发Python导入路径异常。

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