在 Django 中，当需要根据给定的 ID 或字段值列表（如护照号）精确控制查询结果的返回顺序时，直接使用 __in 查询无法保证顺序；本文介绍三种可靠方案：union() 构造有序 SQL、Python 层 sorted() 重排，以及推荐的数据库级 CASE WHEN 排序。
在 django 中，当需要根据给定的 id 或字段值列表（如护照号）精确控制查询结果的返回顺序时，直接使用 `__in` 查询无法保证顺序；本文介绍三种可靠方案：`union()` 构造有序 sql、python 层 `sorted()` 重排，以及推荐的数据库级 `case when` 排序。
在 Django 开发中，一个常见但易被忽视的需求是：按 Python 列表中定义的特定顺序，获取对应的数据库模型实例。例如，你有一组护照号 ['AA1111111', 'AD2222222', 'AA3333333', ...]，希望查询出的 User 对象严格遵循该顺序——而非数据库默认的任意排列。然而，像 User.objects.filter(passport_number__in=lst) 这样的写法虽能正确筛选数据，却不带 ORDER BY 子句，因此结果顺序由数据库引擎决定（可能依赖索引结构），不可预测。
✅ 方案一：使用 union() 实现 SQL 级顺序（推荐用于小列表）
Django 的 .union() 方法可将多个独立查询以 UNION 方式拼接，天然保留子查询的执行顺序（注意：需加 all=True 避免去重）：
from django.db.models import Q
lst = ['AA1111111', 'AD2222222', 'AA3333333', 'AA4444444', 'АВ5555555']
# 构建按顺序排列的 QuerySet
queryset = User.objects.none().union(
*[User.objects.filter(passport_number=p) for p in lst],
all=True
)
生成的 SQL 类似：
SELECT * FROM user WHERE passport_number = 'AA1111111' UNION ALL SELECT * FROM user WHERE passport_number = 'AD2222222' -- ...
✅ 优势：纯数据库操作，支持后续链式调用（如 .select_related()、.values()）；
⚠️ 注意：性能随列表长度线性下降，仅建议用于 ≤ 100 项的场景；若存在重复 passport_number，all=True 可保留所有匹配项。
✅ 方案二：Python 层排序（简单灵活，牺牲 QuerySet 能力）
若对性能要求不高，或需进一步处理对象，可在内存中重排：
lst = ['AA1111111', 'AD2222222', 'AA3333333', 'AA4444444', 'АВ5555555']
order_map = {passport: idx for idx, passport in enumerate(lst)}
users = list(User.objects.filter(passport_number__in=lst))
sorted_users = sorted(users, key=lambda u: order_map.get(u.passport_number, float('inf')))
✅ 优势：逻辑清晰、调试方便；
❌ 缺陷：返回的是普通 Python list，无法再调用 .filter()、.paginate() 等 QuerySet 方法，且全量加载到内存，大数据集易 OOM。
✅ 方案三（最佳实践）：数据库 CASE WHEN 排序（高效 & 可链式）
利用 Django 的 Case + When 表达式，在 SQL 层实现精准排序，兼顾性能与 QuerySet 完整性：
from django.db.models import Case, When, IntegerField
lst = ['AA1111111', 'AD2222222', 'AA3333333', 'AA4444444', 'АВ5555555']
# 构建 CASE WHEN 排序规则
ordering = Case(
*[When(passport_number=p, then=i) for i, p in enumerate(lst)],
output_field=IntegerField()
)
queryset = User.objects.filter(passport_number__in=lst).order_by(ordering)
生成的 SQL（PostgreSQL 示例）：
SELECT * FROM user
WHERE passport_number IN ('AA1111111', 'AD2222222', ...)
ORDER BY CASE
WHEN passport_number = 'AA1111111' THEN 0
WHEN passport_number = 'AD2222222' THEN 1
-- ...
END
✅ 优势：一次查询、数据库原生排序、完全保留 QuerySet 功能（支持分页、注解、关联查询等）；
? 提示：output_field=IntegerField() 是关键，避免类型推断错误；MySQL/SQLite 同样兼容。
⚠️ 重要注意事项
- 模型命名规范：Django 官方反模式指南明确建议使用单数类名（如 User），而非 Users，以保持一致性；
- 空值与缺失项：若列表中某些 passport_number 在库中不存在，CASE WHEN 和 union() 均会自动跳过；若需补 None 占位，需额外逻辑处理；
- 性能基准：对于千级以上列表，优先测试 CASE WHEN 的执行计划；必要时可为 passport_number 字段添加索引。
综上，Case/When + order_by() 是最平衡的解决方案——它既尊重数据库能力，又无缝融入 Django ORM 生态，应作为首选实践。
