Django 5.x中OneToOneField反向查询失效，如何兼容旧逻辑？

问题背景 #

将Django应用从django==3.2.25迁移至django==5.1.6后，使用switch__config_state=1这类反向关联查询时，出现FieldError: Unsupported lookup 'config_state' for OneToOneField or join on the field not permitted错误，原查询在Django 3.x中可正常运行。

原因分析 #

Django 5.x对跨关联的查询语法做了严格校验，不再允许直接将反向关联名称与主键值直接匹配（原写法依赖旧版本的隐式主键匹配逻辑），必须明确指定要查询的具体字段，消除查询逻辑的歧义。

修改方案 #

方案一：明确指定关联模型的主键字段 #

由于ConfigState的主键就是关联Switch的switch字段，只需在查询中明确指定该字段即可：

# 方式1：使用__pk匹配主键（通用推荐）
EdgeSwitch.objects.filter(switch__config_state__pk=1)

# 方式2：直接指定关联字段名
EdgeSwitch.objects.filter(switch__config_state__switch=1)

修改后生成的SQL逻辑与原Django 3.x版本一致，保持INNER JOIN的查询结构。

方案二：使用子查询实现等价逻辑 #

如果更倾向于显式的关联筛选，也可以用子查询获取符合条件的Switch集合，再关联查询EdgeSwitch：

from django.db.models import Subquery

# 先筛选出拥有指定ConfigState的Switch
valid_switch_ids = Switch.objects.filter(config_state__switch=1).values('id')
# 再查询关联这些Switch的EdgeSwitch
EdgeSwitch.objects.filter(switch__in=Subquery(valid_switch_ids))

验证效果 #

修改后的查询在Django 5.x中可正常生成正确的SQL语句，功能与原代码完全一致，同时符合新版本的语法规范。

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