annotate() + Sum() 多维度分组时，字段别名必须为合法 Python 标识符，禁用点号或空格；应使用下划线命名如 total_amount，且 values() 中字段须为模型字段或 F() 表达式，不可为聚合结果。
用 annotate() + Sum() 做多维度分组聚合时，字段别名不能含点号或空格
直接在 annotate() 里写 Sum('transaction__amount') 没问题，但别名如 total.amount 或 "Total Amount" 会报 FieldError。Django 的查询集字段名必须是合法 Python 标识符。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用下划线命名：例如
annotate(total_amount=Sum('transaction__amount')) - 分组字段（
values()）里的字段必须是模型字段或已定义的F()表达式，不能是聚合结果本身 - 如果需要按月份统计，优先用
TruncMonth('date')而非extra()，后者在 Django 4.2+ 已弃用且易出兼容性问题 - 注意
Sum()对空数据返回None，前端渲染前要处理，比如用Coalesce(Sum(...), 0)
跨多个 ForeignKey 关联表做条件过滤时，select_related() 不起作用
select_related() 只优化正向一对一/外键查询，对反向关联（如 Transaction → Account → Department → Company）或带 filter() 的链式查询无效。盲目加它反而让 SQL 更重。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
prefetch_related()处理反向关系，但仅当后续 Python 层需遍历对象时才必要 - 复杂条件过滤优先走
annotate()+Q()组合，例如查“本季度收入 > 支出的部门”：先annotate(income=Sum(...), expense=Sum(...))，再filter(income__gt=F('expense')) - 避免在循环里调用
.count()或.first()—— 这会触发 N+1 查询，尤其报表常带分页和导出
导出 Excel 时日期格式错乱、数字变科学计数法
Django 自身不处理 Excel 渲染，靠第三方库（如 openpyxl 或 xlsxwriter）。常见问题是：Python datetime 写入单元格后 Excel 默认识别为文本，或大额金额（如 1234567890.12）被转成 1.23457E+9。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
xlsxwriter时，显式设置单元格格式：workbook.add_format({'num_format': 'yyyy-mm-dd'})和{'num_format': '#,##0.00'} - 避免用字符串拼接日期，传原始
datetime对象给write_datetime()方法 - 导出前把 QuerySet 转成列表（
list(qs)），防止多次求值；但注意内存——超 10 万行建议用流式写入或分块iterator(chunk_size=2000)
前端展示动态筛选后，后端 API 接口频繁超时
财务报表常带时间范围、部门树、科目层级等组合筛选。若每次请求都执行全量 annotate() + values()，尤其涉及多表 JOIN 和聚合函数，MySQL/PostgreSQL 很容易卡在 30 秒超时边界。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 对高频筛选字段（如
year_month、department_id）建复合索引，顺序按查询频率从高到低排 - 用数据库物化视图（PostgreSQL）或汇总表（MySQL）预计算周/月级汇总，避免实时聚合
- API 返回只含关键指标（如
total_income,net_profit），明细数据另走分页接口，用limit/offset或游标分页 - 禁用
DEBUG=True下的django-debug-toolbar，它会让聚合查询慢 3–5 倍
TruncYear('created_at') 就能让百万级账单表查询从 200ms 拉长到 12s —— 这类细节，往往比选哪个图表库更决定成败。 
