Django中嵌套for循环遍历查询集效率低下问题求助

这问题我太熟了——Django里嵌套循环遍历查询集导致的N+1查询绝对是性能杀手！咱们一步步拆解问题、解决它：

问题根源：无关联的N+1查询 #

你现在的machine和Performance模型只是通过machine_no做了“逻辑关联”，但没有在数据库层面建立外键约束。这就意味着你遍历每台机器时，都要单独发起一次查询去拉取对应的性能记录——如果有100台机器，就会触发1次机器查询+100次性能查询，也就是所谓的N+1问题，效率自然低到爆炸。

第一步：修复模型，建立数据库关联 #

先把模型改成符合Django最佳实践的结构（模型名建议首字母大写，符合PEP8规范），给Performance添加外键关联到Machine：

from django.db import models
from django.db.models import Sum, Avg  # 后续聚合统计会用到

class Machine(models.Model):
    machine_type = models.CharField(null=True, max_length=10)
    machine_no = models.IntegerField(null=True, unique=True)  # 机器编号建议设为唯一，避免重复
    machine_name = models.CharField(null=True, max_length=255)
    machine_sis = models.CharField(null=True, max_length=255)
    store_code = models.IntegerField(null=True)
    created = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.machine_name or f"Machine {self.machine_no}"

class Performance(models.Model):
    # 用外键关联Machine，替代单独的machine_no字段
    machine = models.ForeignKey(Machine, on_delete=models.CASCADE, related_name="performances")
    power = models.IntegerField(null=True)
    record_time = models.DateTimeField(auto_now_add=True)  # 假设你需要记录性能数据的时间

    def __str__(self):
        return f"{self.machine.machine_no} - Power: {self.power}"

如果你因为历史数据或其他限制暂时无法修改模型，也可以用下面的临时方案，但建立外键是长期最优解——既能保证数据一致性，又能最大化查询效率。

备选：无法改模型时的手动关联 #

from django.db.models import Prefetch, OuterRef

# 手动预取与当前machine_no匹配的Performance记录
performance_prefetch = Prefetch(
    queryset=Performance.objects.filter(machine_no=OuterRef("machine_no")),
    to_attr="related_performances"
)

machines = Machine.objects.all().prefetch_related(performance_prefetch)

第二步：优化查询，彻底解决N+1 #

场景1：需要获取每个机器的所有性能记录 #

用prefetch_related预取所有关联的Performance记录，这样只会发起两次数据库查询：一次拉所有机器，一次拉所有对应性能记录，然后在内存中完成关联：

# 视图中提前查询好数据
machines = Machine.objects.all().prefetch_related("performances")

# 遍历的时候直接用，不会再发新查询
for machine in machines:
    print(f"机器：{machine.machine_name}")
    for performance in machine.performances.all():
        print(f"  功率：{performance.power} | 记录时间：{performance.record_time}")

场景2：只需要性能数据的聚合值（比如平均功率、总功率） #

如果不需要每条性能记录，只是要统计值，用annotate直接在数据库层面完成聚合，一次查询搞定所有统计：

from django.db.models import Avg, Sum, Count

# 一次性获取每个机器的性能统计
machines_with_stats = Machine.objects.annotate(
    avg_power=Avg("performances__power"),
    total_power=Sum("performances__power"),
    performance_count=Count("performances")
)

# 遍历直接用聚合结果，无需嵌套循环
for machine in machines_with_stats:
    print(f"机器：{machine.machine_name}")
    print(f"  平均功率：{machine.avg_power:.2f}")
    print(f"  总功率：{machine.total_power}")
    print(f"  记录条数：{machine.performance_count}")

额外提醒：模板中别触发查询 #

如果你是在Django模板里做嵌套循环，一定要在视图里提前用prefetch_related或annotate处理好数据，绝对不要在模板里写{{ machine.performances.all }}这种会触发新查询的代码——模板里的查询不仅慢，还难调试。

比如视图传处理好的数据到模板，模板直接遍历：

{% for machine in machines %}
    <h3>{{ machine.machine_name }}</h3>
    <ul>
        {% for performance in machine.performances.all %}
            <li>功率：{{ performance.power }} | 时间：{{ performance.record_time }}</li>
        {% endfor %}
    </ul>
{% endfor %}

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