本文介绍使用 django-simple-history 时，如何精准筛选出在某指定日期具有特定历史状态（如 status ≠ 4）的模型实例，包括已存在但状态不符、以及该日期时尚未创建的记录。
本文介绍使用 django-simple-history 时，如何精准筛选出在某指定日期具有特定历史状态（如 status ≠ 4）的模型实例，包括已存在但状态不符、以及该日期时尚未创建的记录。
在使用 django-simple-history 追踪模型变更时，一个常见需求是：按某历史时间点（如 limit_date）的状态进行过滤——例如，“获取所有在 2023-10-01 当日 不处于 status=4 状态 的实例”，这包含两类对象：
- 在该日期已存在，且其最新历史记录（≤ limit_date）的 status ≠ 4；
- 在该日期尚不存在（即无任何 ≤ limit_date 的历史记录），自然也不满足 status = 4。
直接使用 Exists + 子查询易误判：若某实例曾为 status=4（后又变更），传统 ~Exists(...status=4...) 会错误排除它——因为它“曾经是 4”，而非“在目标日期是 4”。
✅ 正确解法是：对每个实例，查其截止 limit_date 的最新历史状态，并以此作为注解字段参与过滤。Django 支持通过 Subquery + values()[:1] 获取单值（无需 .filter() 后续操作），规避了“切片后不可再 filter”的限制：
from django.db.models import OuterRef, Q, Subquery
from datetime import date
limit_date = date(2023, 10, 1)
qs = MyModel.objects.annotate(
historic_status=Subquery(
MyModel.history.filter(
id=OuterRef('id'),
history_date__lte=limit_date
)
.order_by('-history_date') # 最新变更优先
.values('status')[:1] # 取第一个（即最新状态值）
)
).filter(~Q(historic_status=4))
? 关键说明：
- Subquery(...values('status')[:1]) 返回标量值（int 或 None），Django 自动将其注入注解字段 historic_status；
- .order_by('-history_date') 确保取到 limit_date 前最后一次变更的状态；
- 若某实例在 limit_date 前无任何历史记录（即刚创建于该日之后），historic_status 为 None，而 ~Q(historic_status=4) 自然包含 None（因 None != 4 为 True），无需额外 | Q(historic_status=None)；
- 此方案纯 SQL 实现，无内存遍历，性能可靠，兼容 Django ≥ 3.2。
⚠️ 注意事项：
- 确保 MyModel.history 的 history_date 字段已建立数据库索引（如 db_index=True），否则 history_date__lte 查询可能变慢；
- 若需严格区分“不存在”与“显式为 NULL 状态”，可保留 | Q(historic_status=None) 显式逻辑；
- 避免在 Subquery 中使用 .first() 或 .get() —— 它们触发即时求值，破坏 QuerySet 延迟执行特性。
此方法优雅解决了“时间点状态快照过滤”这一典型场景，是 django-simple-history 高级用法中的关键实践。
