如何基于指定日期的历史状态过滤 Django QuerySet

本文介绍使用 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 高级用法中的关键实践。