Django模板中如何展示多对多关联的单据凭证数据？

1. 先确认模型关联的正确性 #

假设你的模型结构如下（如果和实际有出入，调整对应字段名即可）：

from django.db import models

class Ordenes_Compra(models.Model):
    # 采购订单核心字段
    numero = models.CharField(max_length=50)
    fecha = models.DateField()
    # 多对多关联单据凭证，设置related_name方便反向查询
    imagenes = models.ManyToManyField(
        'Imagenes_Comprobantes_Moviemientos',
        related_name='ordenes_compra',
        blank=True
    )

class Movimientos(models.Model):
    # 异动核心字段
    tipo = models.CharField(max_length=50)
    descripcion = models.TextField()
    # 外键关联采购订单，设置related_name
    orden_compra = models.ForeignKey(
        Ordenes_Compra,
        on_delete=models.CASCADE,
        related_name='movimientos',
        null=True, blank=True
    )

class Imagenes_Comprobantes_Moviemientos(models.Model):
    # 单据凭证核心字段
    ruta_imagen = models.FileField(upload_to='comprobantes/')
    nota = models.CharField(max_length=200, blank=True)

• 重点核对related_name的拼写：确保反向查询的字段名和后续模板、视图中使用的一致，避免因名称不匹配导致关联数据无法获取。

2. 视图中预取关联数据（关键修复点） #

模板嵌套查询失效，绝大多数情况是视图未预取关联数据，导致Django的惰性查询在模板环境中无法正确触发，甚至引发N+1查询问题。

修改视图代码，使用select_related（预取外键关联）和prefetch_related（预取多对多关联）批量加载所有需要的数据：

from django.shortcuts import render
from .models import Movimientos

def lista_movimientos(request):
    # 一次性预取异动→采购订单→单据凭证的所有关联数据
    movimientos = Movimientos.objects.all() \
        .select_related('orden_compra') \
        .prefetch_related('orden_compra__imagenes')
    return render(request, 'tu_template.html', {'movimientos': movimientos})

3. 修正模板中的嵌套循环逻辑 #

确保模板变量名与模型、视图传递的变量完全匹配，循环层级正确：

<table>
    <thead>
        <tr>
            <th>异动类型</th>
            <th>采购订单编号</th>
            <th>关联单据凭证</th>
        </tr>
    </thead>
    <tbody>
        {% for movimiento in movimientos %}
        <tr>
            <td>{{ movimiento.tipo }}</td>
            <td>
                {% if movimiento.orden_compra %}
                    {{ movimiento.orden_compra.numero }}
                {% else %}
                    无关联采购订单
                {% endif %}
            </td>
            <td>
                {% if movimiento.orden_compra %}
                    <ul>
                        {% for imagen in movimiento.orden_compra.imagenes.all %}
                        <li>
                            <img src="{{ imagen.ruta_imagen.url }}" alt="单据凭证" style="width:100px;">
                            <p>{{ imagen.nota }}</p>
                        </li>
                        {% empty %}
                        <li>无关联单据凭证</li>
                        {% endfor %}
                    </ul>
                {% else %}
                    无关联单据凭证
                {% endif %}
            </td>
        </tr>
        {% endfor %}
    </tbody>
</table>

• 注意：遍历多对多关联数据必须使用imagenes.all，直接写imagenes不会返回可迭代的查询集。
• 增加{% if %}判断，避免关联数据为空时出现模板渲染错误。

常见排查点 #

• 核对数据库数据：确认某条异动确实关联了采购订单，且该采购订单关联了单据凭证，避免因无数据导致循环“失效”的假象。
• 检查字段约束：如果关联字段未设置null=True/blank=True，但数据库中无关联数据，会直接抛出异常。
• 检查变量拼写：比如把orden_compra写成ordencompra，或imagenes写成imagen，都会导致循环无法获取数据。

内容的提问来源于stack exchange，提问作者Leonardo Daniel Costas Martine