如何在Django HTML模板中打印所有License对象及其关联的最新Timeline记录

• 视图层循环语法错误：原代码中for license.id in licenses:不符合Python语法规范，循环变量使用错误
• 视图层变量覆盖问题：timeline变量在每次循环时都会被新的查询结果覆盖，循环结束后仅保留最后一个License对应的最新Timeline记录，传到模板后自然只能输出单条数据
• 视图层没有正确传递全量数据：没有将所有License和对应最新Timeline的关联数据打包传入模板上下文
• 模板层遍历对象错误：仅遍历最终的单个timeline变量，无法输出全部许可证信息

第一步：修正视图层逻辑 #

我们先将所有License实例和其对应的最新Timeline实例组装成统一的列表，再传入模板上下文，代码如下：

def home(request):
    title = "Licences"
    agencies = Agency.objects.all()
    agent = Agency.objects.get(pk=1)
    # 组装许可证+最新更新记录的列表
    license_timeline_list = []
    for license in License.objects.all():
        # 获取当前许可证对应的最新一条Timeline记录
        latest_timeline = Timeline.objects.filter(license=license).order_by('-id').first()
        license_timeline_list.append({
            "license": license,
            "latest_timeline": latest_timeline
        })
    # 传递数据到模板，注意替换为你实际的模板文件路径
    return render(request, "你的模板路径.html", {
        "title": title,
        "agencies": agencies,
        "agent": agent,
        "license_timeline_list": license_timeline_list
    })

第二步：修正模板层遍历逻辑 #

遍历视图传入的全量license_timeline_list，输出每条许可证的信息，代码如下：

{% for item in license_timeline_list %}
<!-- 可按需添加判断：仅展示有Timeline记录的许可证 -->
{% if item.latest_timeline %}
<tr>
    <td align="center">
        <a href="{% url 'licenseupdate' item.license.id %}" class="btn btn-default"><em class="fa fa-pencil"></em></a>
        <a href="{% url 'removeobject' item.license.id %}" class="btn btn-danger"><em class="fa fa-trash"></em></a>
    </td>
    <td> <a href="{% url 'timelines' item.license.id %}"> {{item.license.description}}</a></td>
    <td>{{item.license.location}}</td>
    <td>{{item.license.renewal_frequency}}</td>
    <td>{{item.latest_timeline.last_renewed}}</td>
    <td>{{item.latest_timeline.due_date}}</td>
</tr>
{% endif %}
{% endfor %}

原循环写法会产生N+1次数据库查询（1次查所有License，N次查每个License对应的Timeline），可通过Django子查询优化为固定3次查询：

from django.db.models import OuterRef, Subquery

def home(request):
    title = "Licences"
    agencies = Agency.objects.all()
    agent = Agency.objects.get(pk=1)
    # 子查询：获取每个License对应的最新Timeline的ID
    latest_timeline_sub = Timeline.objects.filter(
        license=OuterRef('pk')
    ).order_by('-id').values('id')[:1]
    # 一次性查询所有License，同时标注对应最新Timeline的ID，顺带预取关联的外键、多对多数据避免额外查询
    licenses = License.objects.annotate(
        latest_timeline_id=Subquery(latest_timeline_sub)
    ).select_related('agency').prefetch_related('contact_person')
    # 一次性查询所有需要用到的Timeline记录
    timeline_ids = [lic.latest_timeline_id for lic in licenses if lic.latest_timeline_id]
    latest_timeline_map = {t.license_id: t for t in Timeline.objects.filter(id__in=timeline_ids)}
    # 组装数据
    license_timeline_list = []
    for lic in licenses:
        license_timeline_list.append({
            "license": lic,
            "latest_timeline": latest_timeline_map.get(lic.id)
        })
    # 传递数据到模板，注意替换为你实际的模板文件路径
    return render(request, "你的模板路径.html", {
        "title": title,
        "agencies": agencies,
        "agent": agent,
        "license_timeline_list": license_timeline_list
    })

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