Laravel Eloquent关联：通过student_id获取对应用户名

嘿，这个需求太常见了，我给你几个实用的方案，你可以根据自己的实际场景来选：

方案一：给Project模型添加外键关联（强烈推荐） #

如果你的数据库还处于可以调整的阶段，优先给Project模型的student_id改成外键关联User，这完全符合Django ORM的设计规范，后续维护和查询都会更省心。

修改模型代码 #

原来的Project模型可能是这样的：

from django.db import models

class Project(models.Model):
    student_id = models.IntegerField()
    # 其他项目字段...

把它改成外键关联：

from django.db import models
from django.contrib.auth.models import User  # 如果你用的是Django自带的User模型

class Project(models.Model):
    # 用student替代原来的student_id，关联User模型
    student = models.ForeignKey(User, on_delete=models.CASCADE, related_name="projects")
    # 其他项目字段...

迁移数据库 #

修改完模型后，执行迁移命令让数据库同步变更：

python manage.py makemigrations
python manage.py migrate

注意：如果已经有存量数据，Django会自动把原来的student_id值映射到新的外键字段上，建议先备份数据再操作。

视图与模板处理 #

在视图里查询Project时，用select_related预加载关联的User对象，避免N+1查询问题：

# 视图函数/类视图中获取所有项目
projects = Project.objects.all().select_related("student")

然后在模板里直接调用关联用户的用户名：

{% for project in projects %}
    <div>
        <p>项目名称：{{ project.name }}</p>  <!-- 你的其他项目字段 -->
        <p>提交学生：{{ project.student.username }}</p>
    </div>
{% endfor %}

方案二：不修改模型，手动实现关联查询（适合无法调整模型的场景） #

如果因为各种限制不能修改模型结构，也可以用下面的方法实现：

方法1：给Project模型添加属性方法 #

在Project模型里新增一个student_name属性，用来获取对应用户名：

class Project(models.Model):
    student_id = models.IntegerField()
    # 其他项目字段...

    @property
    def student_name(self):
        try:
            # 根据student_id查询对应用户的用户名
            return User.objects.get(id=self.student_id).username
        except User.DoesNotExist:
            return "未知用户"  # 处理用户不存在的异常情况

然后在视图里正常查询Project：

projects = Project.objects.all()

模板中直接调用这个属性：

{% for project in projects %}
    <p>提交学生：{{ project.student_name }}</p>
{% endfor %}

注意：这种方法会触发N+1查询（每个Project都查一次User），数据量大时性能会受影响，建议用下面的优化版。

方法2：批量查询优化性能 #

在视图里先批量获取所有需要的用户，再手动映射给Project对象，只需要两次数据库查询：

from django.contrib.auth.models import User

# 1. 获取所有项目
projects = Project.objects.all()
# 2. 收集所有项目的student_id，去重
student_ids = list({p.student_id for p in projects})
# 3. 批量查询这些id对应的用户，转成id:username的字典
user_username_map = {user.id: user.username for user in User.objects.filter(id__in=student_ids)}
# 4. 给每个Project对象添加student_name属性
for project in projects:
    project.student_name = user_username_map.get(project.student_id, "未知用户")

模板里还是用{{ project.student_name }}即可，这种方法性能比单个查询好很多。

方法3：用Subquery在数据库层面关联 #

还可以用Django的Subquery在数据库层面直接关联查询用户名，性能也不错：

from django.db.models import Subquery, OuterRef
from django.contrib.auth.models import User

# 构造子查询，根据student_id获取对应的用户名
username_subquery = User.objects.filter(id=OuterRef("student_id")).values("username")[:1]
# 给Project查询集添加student_name注解
projects = Project.objects.all().annotate(student_name=Subquery(username_subquery))

模板里直接使用{{ project.student_name }}就行。

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