Django Salary模型加班总薪资聚合加HTML展示后错误返回数据库行数

你遇到的“求和结果返回数据库行数、逐行数量匹配”的异常，本质是Django ORM的聚合逻辑被查询集构造、模板渲染层的错误配置覆盖，触发逻辑非常明确：

• 概念混淆：把全局聚合的aggregate和逐行注解的annotate搞混。aggregate会对整个过滤后的查询集做全局计算，返回单个数值的字典；annotate会给查询集中的每一行记录附加一个计算字段，返回带逐行值的QuerySet，元素数量和数据库返回的行数完全一致。
• 命名冲突+取值路径错误：Django模板解析取值时，会优先读取QuerySet对象上挂载的属性、同名字段。很多人在加HTML总计逻辑时，为了逐行展示单条记录的加班额，给查询集加了和total_overtime同名的annotate字段，之后写模板时手滑把全局总计的取值从{{ total_overtime }}（上下文传入的全局值）写成了{{ salary_list.total_overtime }}，这时候就会直接拿到逐行的字段值组成的列表，列表长度刚好等于数据库行数，和你遇到的症状完全匹配。

• 首先梳理代码逻辑：你写的这段total_overtime方法本身没有语法错误，计算逻辑是对的，但这类跨全表的聚合计算，不适合绑定为Model的实例方法——正确的做法是把全局计算逻辑放在视图层单独执行，作为独立变量传入模板上下文：

  # 视图层示例
  from django.shortcuts import render
  from django.db.models import Sum
  from .models import Salary
  
  def salary_list_view(request):
      # 单独计算全局加班总薪资
      total_overtime = (
          Salary.objects
          .filter(currency='Tenge')
          .aggregate(total=Sum('overtime', field="overtime*overtime_hourly_rate"))
      )['total']
      # 拿到逐行展示的薪资列表
      salary_list = Salary.objects.filter(currency='Tenge')
      return render(request, 'salary.html', {
          'salary_list': salary_list,
          'total_overtime': total_overtime
      })
  

• 调整命名避坑：如果之前为了逐行展示单条记录的加班金额给查询集加过注解，把注解字段名改成和全局总计不同的名称，比如单条记录的加班额用row_overtime_pay，全局总计用total_overtime_pay，从根源上避免命名冲突导致的解析错误。
• 核对模板取值路径：渲染总计值时，直接取上下文传入的全局变量，不要从逐行的salary_list QuerySet上读取同名属性，避免触发QuerySet的字段解析。
• 补充排查方向：如果你的HTML总计是基于Django Admin自带的总计行实现的，检查列配置的计算表达式——Admin列总计如果没有正确绑定求和逻辑，会默认返回当前查询集的总行数，和你遇到的异常表现完全吻合。

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