Django中如何在detail view的单个模板渲染外键关联的两个模型内容

你遇到的是Django单视图加载多关联模型数据的典型场景，针对不同的视图写法分别对应以下解决方案：

1 通用类视图（DetailView）处理方案 #

1.1 扩展上下文变量 #

默认DetailView仅会传递主模型的实例到模板上下文，你可以重写get_context_data方法手动加入关联的Reports数据：

from django.views.generic import DetailView
from .models import Company, Reports

class CompanyDetailView(DetailView):
    # 主模型设为Company
    model = Company
    template_name = "company_detail.html"
    # 自定义模板中调用Company实例的变量名
    context_object_name = "company"

    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        # 新增Reports查询集到上下文
        # 外键反向关联默认用 小写模型名_set，可在外键字段通过related_name自定义
        context["reports"] = self.object.reports_set.all()
        return context

1.2 预加载优化查询 #

如果需要减少数据库查询次数，可重写get_queryset方法预加载关联数据：

def get_queryset(self):
    # prefetch_related用于一对多关联的预加载
    return super().get_queryset().prefetch_related("reports_set")

采用这种写法无需额外修改上下文，直接在模板中通过{{ company.reports_set.all }}即可遍历关联的报告数据。

2 函数视图处理方案 #

如果用的是FBV（函数视图），直接在渲染模板时传入两个模型的变量即可：

from django.shortcuts import get_object_or_404, render
from .models import Company, Reports

def company_detail(request, company_id):
    company = get_object_or_404(Company, id=company_id)
    reports = Reports.objects.filter(company=company)
    return render(request, "company_detail.html", {
        "company": company,
        "reports": reports
    })

3 模板调用示例 #

不管用哪种视图写法，模板中都可以直接调用两个模型的字段内容：

<!-- 渲染Company模型内容 -->
<div class="company-info">
    <h1>{{ company.full_name }}</h1>
    <p>统一社会信用代码：{{ company.credit_code }}</p>
    <p>成立时间：{{ company.found_date }}</p>
</div>

<!-- 渲染关联的Reports模型内容 -->
<div class="reports-list">
    <h2>企业披露报告</h2>
    {% for report in reports %}
    <div class="report-card">
        <h3>{{ report.report_title }}</h3>
        <p>报告期：{{ report.report_period }}</p>
        <p>披露时间：{{ report.publish_time }}</p>
        <a href="{{ report.file_url }}" target="_blank">查看报告全文</a>
    </div>
    {% empty %}
    <p>该企业暂未披露相关报告</p>
    {% endfor %}
</div>

常见排查点 #

如果修改后仍无法同时加载两个模型的内容，可逐一检查以下项：

• 外键字段的related_name配置是否正确：如果Reports模型的外键字段设置了related_name="company_reports"，反向关联时需要用self.object.company_reports.all，而非默认的reports_set
• 确认存在关联数据：检查数据库中是否有对应Company id的Reports记录，没有数据的话模板会走empty分支
• 上下文变量名是否拼写正确：Django模板默认静默忽略不存在的变量，拼写错误会导致内容为空不会报错

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