如何在Django中通过user_id字段为Role查询集关联User对象？

现有模型代码 #

from django.db import models, F, Q

class User(models.Model):
    pass


class Role(models.Model):
    # 其他字段省略
    user_id = models.PositiveIntegerField(
        verbose_name='Related object ID'
    )

需求与尝试 #

需要不使用ForeignKey或ManyToMany字段，通过user_id为Role查询集关联对应的User对象，尝试代码如下：

roles = Role.objects.all()
roles = roles.annotate(user=Q(User.objects.get(id=F('user_id'))))

for role in roles:
    print(role.user.id)  # 期望输出123

报错信息 #

执行后触发错误：

FieldError: Cannot resolve keyword 'user_id' into field

正确实现方案 #

方案一：使用Subquery关联User字段（适合仅需部分字段场景） #

无法直接通过注解获取完整User实例，但可以用Subquery和OuterRef关联单个字段：

from django.db.models import Subquery, OuterRef

# 构造子查询，匹配当前Role的user_id
user_subquery = User.objects.filter(id=OuterRef('user_id'))

# 为Role查询集添加需要的User字段注解
roles = Role.objects.annotate(
    user_username=Subquery(user_subquery.values('username')[:1]),
    user_id=Subquery(user_subquery.values('id')[:1])
)

# 使用示例
for role in roles:
    print(role.user_id)       # 输出关联User的id
    print(role.user_username) # 输出关联User的用户名

方案二：批量查询后手动关联（推荐，可获取完整User实例） #

这种方式避免N+1查询，同时能直接拿到User模型实例：

# 1. 查询所有Role对象
roles = Role.objects.all()

# 2. 收集所有需要关联的user_id，批量查询User
user_ids = [role.user_id for role in roles]
user_map = {user.id: user for user in User.objects.filter(id__in=user_ids)}

# 3. 为每个Role手动绑定user属性
for role in roles:
    role.user = user_map.get(role.user_id)

# 使用示例
for role in roles:
    if role.user:
        print(role.user.id)

关键说明 #

• 原代码错误原因：Q(User.objects.get(id=F('user_id')))的写法不合法，F('user_id')无法在子查询外被解析，且annotate不能直接注解模型实例。
• 方案二更贴合需求，能直接获取完整的User实例，性能也更优。

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