Django+MongoDB登录报错：Cannot force an update in save() with no primary key

这个ValueError: Cannot force an update in save() with no primary key错误的核心是：Django尝试对未包含有效主键值的模型实例执行强制更新操作（save(force_update=True)）。结合MongoDB的非关系型特性，常见触发场景有以下几种：

• 自定义User模型未正确配置主键字段，导致实例创建/查询时主键未被赋值
• 登录逻辑中错误使用force_update=True调用save()，而此时用户实例的主键字段为空
• Django与MongoDB的ORM适配（如djongo）未正确处理主键映射，导致主键无法被正确识别

1. 检查自定义User模型的主键配置 #

打开models.py，确认User模型的主键字段是否符合MongoDB要求：

• 若使用djongo作为数据库引擎，推荐用models.ObjectIdField作为主键，且显式设置primary_key=True：

from djongo import models
from django.contrib.auth.models import AbstractBaseUser, BaseUserManager

class UserManager(BaseUserManager):
    # 自定义管理器代码...

class User(AbstractBaseUser):
    _id = models.ObjectIdField(primary_key=True)  # 显式指定MongoDB主键
    username = models.CharField(max_length=100, unique=True)
    # 其他字段...

    objects = UserManager()
    USERNAME_FIELD = 'username'

• 若未显式指定主键，Django会自动创建id字段，但MongoDB默认用_id作为主键，可能出现映射不匹配的情况

2. 检查登录视图中的save()调用 #

打开views.py，找到登录逻辑中调用user.save()的代码：

• 若存在user.save(force_update=True)，确认此时user实例是否有有效主键值：
  • 登录场景下，用户实例应从数据库查询得到，必然包含主键；若出现主键为空，说明查询逻辑有问题（如查询返回的实例未正确加载主键）
  • 若无需强制更新，直接移除force_update=True参数，改用默认的save()（Django会自动判断是新增还是更新）
• 示例错误代码：

# 错误写法：强制更新但实例无主键
user = User(username=request.POST.get('username'))
user.save(force_update=True)

• 修正写法：

# 登录场景：先查询用户，再更新（若需要）
user = User.objects.get(username=request.POST.get('username'))
# 若需更新字段，直接修改后save即可，无需force_update
user.last_login = timezone.now()
user.save()

3. 验证数据库配置正确性 #

打开settings.py，确认MongoDB的数据库配置是否正确：

DATABASES = {
    'default': {
        'ENGINE': 'djongo',
        'NAME': 'your_mongodb_name',
        'CLIENT': {
            'host': 'mongodb://localhost:27017/',
            'username': 'your_username',
            'password': 'your_password',
        }
    }
}

• 确保ENGINE设置为djongo（或对应的MongoDB适配引擎），避免使用默认的SQL引擎
• 确认MongoDB服务正常运行，目标数据库已创建

根据排查结果，对应执行以下修复：

1. 修正User模型主键：为User模型添加_id = models.ObjectIdField(primary_key=True)，然后重新执行：

python manage.py makemigrations
python manage.py migrate

• 注意：若已有数据，需确保MongoDB中现有用户文档的_id字段能被正确映射到模型的_id字段

2. 移除不必要的force_update=True：登录逻辑中，除非明确需要强制更新（极少场景），否则直接调用user.save()即可
3. 重新同步数据库：若修改了模型主键，必须重新执行迁移命令，确保MongoDB的集合结构与Django模型一致

修复后，执行登录操作，检查是否仍触发错误：

• 若错误消失，说明问题已解决
• 若仍报错，查看新的报错栈，确认是否是主键映射或实例加载的问题，可尝试打印user._id查看主键值是否存在

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