Django 5中update_or_create操作一对一反向字段报错求助

问题描述 #

在Django 4.x版本中，以下代码可正常执行，通过update_or_create基于OneToOneField的反向关联（related_name）实现数据的更新或创建：

from django.db import models

class Project(models.Model):
    rough_data = models.OneToOneField(
        "Data",
        related_name="rough_project",
        on_delete=models.SET_NULL,
        null=True,
        blank=True,
    )
    final_data = models.OneToOneField(
        "Data",
        related_name="final_project",
        on_delete=models.SET_NULL,
        null=True,
        blank=True,
    )

class Data(models.Model):
    pass

# 执行更新或创建
data, created = Data.objects.update_or_create(
    rough_project=project, defaults=data_dict
)

但升级到Django 5.x后，执行上述代码会抛出错误：

ValueError: The following fields do not exist in this model: rough_project

查阅官方更新日志未找到相关变更说明，目前只能通过手动判断关联是否存在的方式替代：

data = getattr(project, "rough_data", None)
if data:
    # 执行更新逻辑
else:
    # 创建新的Data对象并关联

原因分析 #

推测是Django 5.x对update_or_create方法的查询参数验证逻辑进行了严格调整：

• rough_project是OneToOneField定义的反向关联名称，并非Data模型的实际数据库字段，它是Django动态生成的反向关联属性
• Django 4.x及更早版本允许隐式将反向关联名称作为查询参数传递给update_or_create，但5.x版本中要求查询参数必须是模型的实际数据库字段，或通过双下划线明确指定的关联查询规则，因此直接使用rough_project=project会被判定为无效字段

解决方案 #

方案1：基于正向关联字段ID查询（推荐） #

利用Project模型中自动生成的rough_data_id外键ID字段查询关联的Data对象，实现原逻辑：

# 注意：将data_dict替换为实际要更新的字段字典
data, created = Data.objects.update_or_create(
    pk=project.rough_data_id,
    defaults=data_dict
)
# 新创建Data对象后关联回Project
if created:
    project.rough_data = data
    project.save()

方案2：优化手动判断逻辑 #

简化现有替代方案，直接利用OneToOneField的反向关联特性获取对象：

data = project.rough_data
if data:
    # 批量更新字段
    Data.objects.filter(pk=data.pk).update(**data_dict)
else:
    data = Data.objects.create(**data_dict)
    project.rough_data = data
    project.save()

方案3：使用反向关联的嵌套查询 #

若坚持使用反向关联作为查询条件，可通过Project模型的正向关联进行嵌套查询：

data, created = Data.objects.update_or_create(
    pk=Project.objects.filter(pk=project.pk).values_list('rough_data_id', flat=True).first(),
    defaults=data_dict
)
if created:
    project.rough_data = data
    project.save()

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