Apache24部署Django时出现不存在的MaterialsAPI模块找不到错误

部署在Apache24上的Django项目（项目名API_Materials）此前运行正常，近期执行python manage.py makemigrations时突然抛出ModuleNotFoundError，提示找不到'MaterialsAPI'模块，但项目内不存在任何与该名称相关的文件。

已尝试的调试步骤 #

• 执行git reset --hard回退版本并恢复备份，问题未解决；
• 输入错误命令makemigration（少写末尾的s），仍触发相同错误；
• 检查settings.py中的INSTALLED_APPS配置项，确认未包含MaterialsAPI；
• 发现执行命令过程中目录异常切换，怀疑Apache配置的虚拟环境路径错误，修改后重启Apache无效；
• 查看环境变量，发现DJANGO_SETTINGS_MODULE被设为MaterialsAPI.settings，手动修改后运行manage.py会自动重置为错误值；
• 该问题仅出现在当前部署环境，本地其他环境运行完全正常。

解决思路 #

1. 排查环境变量的持久化配置 #

• 检查部署环境的系统级配置文件（如/etc/profile、~/.bashrc、~/.profile），查找是否有硬编码设置DJANGO_SETTINGS_MODULE=MaterialsAPI.settings的行，删除后执行source命令重新加载配置（例如source ~/.bashrc）。
• 检查Apache虚拟主机配置文件（如httpd-vhosts.conf），查看WSGIDaemonProcess或WSGIProcessGroup段是否设置了错误的DJANGO_SETTINGS_MODULE环境变量，将其修改为API_Materials.settings后重启Apache。
• 检查项目根目录下是否存在.env文件，若有则查看其中的DJANGO_SETTINGS_MODULE配置，修正为正确值后保存。

2. 验证WSGI配置文件 #

• 打开项目的wsgi.py文件，确认os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'API_Materials.settings')这一行的设置正确，未被修改为MaterialsAPI.settings。
• 若使用虚拟环境，检查WSGI配置中指定的虚拟环境路径是否正确，避免加载了其他项目的环境配置。

3. 确保Python环境一致性 #

• 执行which python和python -m django --version，确认当前使用的Python解释器和Django版本与本地正常环境一致，避免版本差异导致的配置加载异常。
• 对比本地与部署环境的requirements.txt，确认依赖包版本一致，执行pip install -r requirements.txt重新安装依赖。

4. 清理缓存文件 #

• 删除项目根目录下的__pycache__文件夹、所有*.pyc文件，以及migrations目录下除__init__.py外的迁移文件，之后重新执行python manage.py makemigrations。

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