使用Djongo时频繁提示执行migrate及数据丢失问题求助

一、核心诱因分析 #

1. DEFAULT_AUTO_FIELD的适配问题 #

Djongo作为Django与MongoDB的适配层，对Django默认的BigAutoField支持存在兼容性问题。MongoDB原生默认使用ObjectId作为集合主键，而BigAutoField是整数自增类型，若全局配置使用BigAutoField作为默认主键，Djongo在同步schema时可能出现以下问题：

• 无法识别MongoDB集合已存在的主键结构，误判为未完成迁移，反复提示运行python manage.py migrate
• 执行migrate时，可能强制重置集合结构，导致已有数据被清空

2. 其他常见诱因 #

• 模型未显式指定主键，依赖默认字段时，Djongo的schema生成逻辑出现冲突
• Djongo与Django版本不兼容，导致迁移检测逻辑异常
• 手动修改过MongoDB集合的结构，导致Djongo元数据与实际集合不匹配
• Django迁移缓存异常，重复触发迁移检测

二、排查步骤 #

1. 检查所有模型的主键定义，确认是否存在未显式指定主键的情况
2. 登录MongoDB查看对应集合的_id字段类型，判断是ObjectId还是整数类型
3. 查看项目migrations目录，检查是否存在重复生成或涉及主键变更的迁移文件
4. 临时切换DEFAULT_AUTO_FIELD为djongo.models.ObjectIdField，观察问题是否复现

三、具体修改方案 #

1. 调整主键配置适配MongoDB #

方案一：全局修改settings.py

将默认主键字段替换为Djongo适配的ObjectIdField：

# settings.py
DEFAULT_AUTO_FIELD = 'djongo.models.ObjectIdField'

方案二：模型显式指定主键

在每个模型中直接定义ObjectId类型的主键，避免依赖全局配置：

# models.py
from djongo import models

class ExampleModel(models.Model):
    id = models.ObjectIdField(primary_key=True)
    name = models.CharField(max_length=100)
    # 其他字段定义

2. 修复迁移状态 #

若已生成错误的迁移文件，需清理并重置迁移状态：

1. 删除migrations目录下除__init__.py外的所有文件
2. 执行空迁移生成：

python manage.py makemigrations --empty

3. 标记迁移为已应用，避免实际修改集合：

python manage.py migrate --fake

3. 调整数据插入代码 #

使用ObjectId主键时，无需手动指定id字段，Djongo会自动生成：

# 正确插入示例
instance = ExampleModel(name="test")
instance.save()

# 若需手动指定id，需使用有效的ObjectId
from bson.objectid import ObjectId
instance = ExampleModel(id=ObjectId(), name="manual_id")
instance.save()

4. 版本兼容性验证 #

确认Djongo与Django版本匹配：

• Django 4.x → Djongo 1.3.x及以上
• Django 3.x → Djongo 1.2.x及以上

四、验证方法 #

1. 调整配置后重启服务
2. 插入测试数据，观察是否仍出现migrate提示
3. 间隔一段时间后检查数据是否存在
4. 执行python manage.py showmigrations确认所有迁移均标记为已应用

内容的提问来源于stack exchange，提问作者이환주