本文介绍使用 django-simple-history 时，如何准确筛选出在给定日期具有特定历史状态（或尚未创建）的模型实例，核心是通过 subquery + order_by + values[:1] 获取每个对象在目标时间点的最新有效状态。
本文介绍使用 django-simple-history 时，如何准确筛选出在给定日期具有特定历史状态（或尚未创建）的模型实例，核心是通过 subquery + order_by + values[:1] 获取每个对象在目标时间点的最新有效状态。
在使用 django-simple-history 追踪模型变更时，一个常见需求是：查询所有在某指定日期（如 2024-06-01）不处于 status = 4 状态的实例——这包括两类对象：
- 当日已存在且 status ≠ 4；
- 当日尚不存在（即首次创建时间晚于该日期）。
直接使用 ~Exists(...filter(status=4)) 会错误排除那些曾为 status=4 但后续已变更的对象，因为它只检测“是否曾经为 4”，而非“在目标日期是否为 4”。
正确解法是：对每个实例，查其历史记录中 history_date ≤ limit_date 的最新一条状态，并以此作为该实例在目标日期的“快照状态”。Django 支持通过 Subquery 实现这一逻辑：
Django Unfold
下载
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
from django.db.models import OuterRef, Subquery, Q
limit_date = datetime.date(2024, 6, 1)
MyModel.objects.annotate(
historic_status=Subquery(
MyModel.history.filter(
id=OuterRef('id'),
history_date__lte=limit_date
)
.order_by('-history_date') # 关键：按时间倒序，确保取最新变更
.values('status')[:1] # 取第一条（即最接近 limit_date 的状态）
)
).filter(~Q(historic_status=4))✅ 为什么有效？
- history_date__lte=limit_date 确保只考虑截止该日期前的所有变更；
- .order_by('-history_date') + .values('status')[:1] 组合可安全获取「截至该日期的最终状态」——即使该实例在当日尚未创建，子查询将返回空结果，historic_status 为 None；
- ~Q(historic_status=4) 自动涵盖 None（即未创建）和非 4 的两种情况（Django 中 None != 4 为 True），无需显式写 | Q(historic_status=None)。
⚠️ 注意事项：
- Subquery 必须配合 annotate() 使用，不可直接在 filter() 中嵌套带切片的子查询；
- values('status')[:1] 是合法的，它返回单值标量子查询（scalar subquery），与 Exists 或完整对象子查询语义不同；
- 确保 history_date 字段有数据库索引（如 db_index=True），否则 order_by('-history_date') 在大数据量下性能不佳；
- 若需兼容 PostgreSQL/MySQL/SQLite，该方案全数据库支持，无需额外适配。
此方法规避了 QuerySet.slice() 后不可再 filter() 的限制，是 Django ORM 中处理「时间点快照过滤」的标准、健壮且生产就绪的实践。
