Django+Gunicorn遇ImportError求助：找不到application模块

嘿，我太懂这种迁移清理后踩坑的滋味了——咱们一步步来排查解决，这个问题本质是删除迁移文件后，系统里还残留着对已移除应用/模块的引用，导致Django和WSGI服务器加载失败，进而触发502错误。

第一步：检查配置文件的应用引用 #

先打开你的settings.py，重点看INSTALLED_APPS列表，确认里面有没有你删掉的那个application相关条目，如果有，直接移除它。另外还要留意settings.py里其他可能关联该应用的配置，比如AUTH_USER_MODEL、自定义模板路径、信号配置等，确保没有残留引用。

第二步：清理数据库的迁移记录 #

你删除了本地迁移文件，但数据库的django_migrations表大概率还留着对应应用的迁移记录，这会让Django误以为该应用还存在。可以这么处理：

1. 进入Django命令行：python manage.py shell
2. 执行以下代码删除对应应用的记录（把'application'换成你实际删除的应用名）：

   from django.db import connection
   with connection.cursor() as cursor:
       cursor.execute("DELETE FROM django_migrations WHERE app = 'application';")
   

3. 退出shell后，运行python manage.py migrate --fake，让Django重新同步迁移状态，避免后续迁移报错。

第三步：清理缓存并重启服务 #

Python和WSGI服务器都会缓存模块引用，必须彻底清理：

• 删除项目根目录和所有应用目录下的__pycache__文件夹；
• 如果用的是Gunicorn、uWSGI这类服务器，完全重启服务（别只重载），确保旧的模块缓存被清除；
• 要是用Docker部署，直接重启容器，保证镜像里的旧文件被更新。

第四步：排查项目内的残留引用 #

搜索整个项目，看看有没有其他Python文件还在导入这个application模块。可以用终端命令快速查找：

grep -r "import application" . --include="*.py"

找到所有引用的地方，把这些导入语句删掉或者注释掉，别漏了views、urls、信号量、表单这类文件。

第五步：验证修复效果 #

先在本地运行python manage.py runserver，看看ImportError是否消失。如果本地正常，再部署到服务器，重启服务后检查502错误是否解决。

额外提醒 #

以后处理迁移或删除应用时，尽量用Django官方推荐的方式：

• 删除应用前，先从INSTALLED_APPS移除，再运行python manage.py migrate [app_name] zero回滚所有迁移，之后再删除应用文件；
• 合并迁移推荐用python manage.py squashmigrations命令，手动删文件很容易留下隐患。

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