Django项目从Windows迁移到Ubuntu后无法导入akita_app报错求助

根因说明 #

1. Django 3.2 版本相比你原环境的3.0.6，强化了AppConfig配置的合法性校验，低版本中不规范的配置会直接触发报错
2. Windows系统对文件名大小写不敏感，掩盖了配置和实际文件名不匹配的问题，迁移到大小写敏感的Ubuntu系统后问题暴露
3. 核心错误点：你的应用文件夹名为akitaapp，但akitaapp/apps.py中AkitaAppConfig的name属性写为akita_app，Django加载时按name属性查找模块，无法匹配到对应路径

具体修复步骤 #

• 修改akitaapp/apps.py配置，将name属性改为和实际文件夹名、INSTALLED_APPS中注册的名称完全一致：

from django.apps import AppConfig

class AkitaAppConfig(AppConfig):
    name = 'akitaapp'

• 检查项目中其他引用应用名的配置：打开akita_project/router.py文件，确认数据库路由逻辑中所有用到应用名的位置，将akita_app同步修改为akitaapp，避免后续数据库操作报错
• 清除项目缓存：在manage.py所在目录执行如下命令，删除所有旧的编译缓存文件，避免缓存干扰

find . -name "__pycache__" -exec rm -r {} \;

• 统一依赖版本：建议将Windows环境的依赖导出覆盖当前的requirements.txt，在Ubuntu虚拟环境执行pip install -r requirements.txt，确保所有依赖版本和原运行环境一致，避免其他版本兼容问题
• 执行python manage.py check验证配置是否恢复正常

额外注意事项 #

如果后续运行出现DEFAULT_AUTO_FIELD相关的告警，是Django 3.2的版本特性导致，在settings.py末尾添加如下配置即可消除：

DEFAULT_AUTO_FIELD = 'django.db.models.AutoField'

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