解决Django迁移冲突：socialaccount依赖sites未提前部署问题

环境说明 #

• Django版本：4.2.4
• 数据库：生产环境使用PostgreSQL，本地开发使用默认SQLite
• 初始INSTALLED_APPS包含allauth、allauth.account、allauth.socialaccount，已执行过migrate操作

问题描述 #

为生成站点地图，新增django.contrib.sites和django.contrib.sitemaps到INSTALLED_APPS后，执行python3 manage.py migrate触发以下错误：

django.db.migrations.exceptions.InconsistentMigrationHistory: Migration socialaccount.0001_initial is applied before its dependency sites.0001_initial on database 'default'.

需在不删除数据、避免服务停机的前提下解决该问题。

临时解决方案 #

分两种场景处理：

场景1：未使用allauth.socialaccount #

直接从INSTALLED_APPS中移除allauth.socialaccount，再执行python3 manage.py migrate即可解决问题。

场景2：已使用allauth.socialaccount且存在数据 #

1. 执行python3 manage.py makemigrations（确保当前代码无未生成的迁移文件）
2. 执行python3 manage.py migrate完成现有迁移
3. 备份并删除socialaccount相关数据表的所有数据
4. 将django.contrib.sites添加到INSTALLED_APPS，且置于allauth.socialaccount之前
5. 重新执行python3 manage.py migrate

问题原因 #

• allauth.socialaccount的迁移依赖django.contrib.sites的初始迁移，但初始配置时未同时启用sites应用
• 若需同时使用两者，必须将django.contrib.sites放在INSTALLED_APPS中allauth.socialaccount的前面，否则会出现socialaccount迁移先于sites执行的情况，后续添加sites时触发依赖冲突

复现步骤 #

1. 在INSTALLED_APPS中添加allauth、allauth.account、allauth.socialaccount
2. 执行python3 manage.py migrate完成迁移
3. 后续将django.contrib.sites添加到INSTALLED_APPS
4. 再次执行python3 manage.py migrate，即可触发相同错误

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