本文介绍如何在 Django 中动态获取节日期间所有实际出现过的音乐流派及其演出人数，避免硬编码流派 ID，实现模型驱动的报表展示。通过 select_related 优化查询，并在视图中聚合数据后以字典形式传递至模板，使新增流派无需修改代码即可自动纳入统计。
本文介绍如何在 django 中动态获取节日期间所有实际出现过的音乐流派及其演出人数，避免硬编码流派 id，实现模型驱动的报表展示。通过 `select_related` 优化查询，并在视图中聚合数据后以字典形式传递至模板，使新增流派无需修改代码即可自动纳入统计。
在构建 Festival 报表时，若将流派（Genre）硬编码为 '1'、'2'、'3' 等固定 ID（如原视图中 musician.filter(genre='1')），会导致系统缺乏可扩展性：每当数据库新增一个 Genre 实例，就必须同步修改视图逻辑与模板结构，违背 DRY 原则且易出错。
理想的解决方案是让报表完全由数据驱动——仅统计在指定节日期间（startdate–enddate 范围内）真实参与演出的流派，并按其实际名称与数量动态呈现。这要求我们：
- 精准筛选时间范围内的音乐人；
- 高效关联流派信息，避免 N+1 查询；
- 在 Python 层完成流派分组与计数，而非依赖 SQL 分组（便于后续扩展逻辑）；
- 将结构化结果以通用方式传入模板，支持任意数量流派的渲染。
✅ 推荐实现：基于字典的动态聚合
以下是重构后的视图函数，已集成性能优化与健壮性处理：
from django.shortcuts import render, get_object_or_404
from collections import defaultdict
def festivalreport(request, pk):
# 使用 get_object_or_404 替代 filter().last()，更安全且语义清晰
festival = get_object_or_404(Festival, id=pk)
# 精确获取该节日期间的音乐人，并预加载 genre 关系（防止 N+1）
musicians = Musician.objects.select_related('genre').filter(
startdate__date__range=[festival.startdate, festival.enddate]
)
# 按 genre 实例分组计数（defaultdict 更简洁，但普通 dict + setdefault 亦可）
genre_counts = defaultdict(int)
for musician in musicians:
if musician.genre: # 防止 genre 为 null 导致 KeyError
genre_counts[musician.genre] += 1
context = {
'festival': festival,
'musicians': musicians,
'genre_counts': dict(genre_counts), # 转为普通 dict 便于模板遍历
}
return render(request, "wwdb/reports/festivalreport.html", context)? 关键改进说明：
- 使用 get_object_or_404 替代 filter(...).last()，避免空结果异常；
- startdate__date__range 确保只比对日期部分（因 Musician.startdate 是 DateTimeField，而 Festival.startdate 是 DateField）；
- select_related('genre') 一次性 JOIN 获取流派名称，避免模板中 {{ genre.name }} 触发额外查询；
- defaultdict(int) 简化计数逻辑，同时显式检查 musician.genre 是否为空，增强鲁棒性。
? 模板层：通用循环渲染
对应模板需彻底移除硬编码的 <h5>Genre 1</h5> 等结构，改用通用迭代：
{% extends "wwdb/base.html" %}
{% block content %}
<div class="container p-5">
<h2>{{ festival.number }} Festival Report</h2>
<p>Start date: {{ festival.startdate }}</p>
<p>End date: {{ festival.enddate }}</p>
</div>
<div class="container p-5">
<h2>Genre Report</h2>
{% if genre_counts %}
{% for genre, count in genre_counts.items %}
<div class="mb-3">
<h5>{{ genre.name }}</h5>
<p>Musician count: {{ count }}</p>
</div>
{% endfor %}
{% else %}
<p class="text-muted">No musicians performed during this festival.</p>
{% endif %}
</div>
{% endblock content %}✅ 此模板能自动适配任意数量、任意名称的流派，包括未来新增或删除的 Genre 实例，真正实现“零维护扩展”。
⚠️ 注意事项与进阶建议
- 空流派处理：当前逻辑跳过 genre=None 的音乐人。若需统计“未分类”类别，可在循环中添加 else 分支，统一归入 None 键；
- 性能边界：当单场音乐人数量极大（如 >10k），Python 层聚合可能成为瓶颈，此时应改用 values('genre__name').annotate(count=Count('id')) 进行数据库聚合（注意：需确保 genre__name 唯一，或改用 genre_id + genre__name 双字段聚合）；
- 缓存优化：节日期间数据变动不频繁，可结合 django.core.cache.cache 对 genre_counts 结果缓存（例如 cache_key = f'festival_{pk}_genre_stats'），显著降低 DB 压力；
- 前端增强：配合 Chart.js 渲染柱状图或饼图，只需将 genre_counts 序列化为 JSON 即可（使用 json_script 模板标签保障 XSS 安全）。
通过以上重构，报表系统从“静态配置型”升级为“数据自适应型”，既提升了可维护性，也为后续添加排序、筛选、导出等功能打下坚实基础。
