本文介绍如何在不修改数据库结构的前提下，安全高效地合并来自两个结构相同但模型不同的 Django QuerySet（如 ProgramAAssignments 和 ProgramBAssignments），重点讲解 union() 方法的使用场景、限制及最佳实践。
本文介绍如何在不修改数据库结构的前提下，安全高效地合并来自两个结构相同但模型不同的 django queryset（如 programaassignments 和 programbassignments），重点讲解 `union()` 方法的使用场景、限制及最佳实践。
在 Django 开发中，当面对历史遗留系统中“同构异表”的场景（即多个模型对应结构完全相同的数据库表，仅表名和模型名不同），常需统一查询逻辑。例如本例中的 ProgramAAssignments 和 ProgramBAssignments 模型，二者字段定义一致（如均含 assignment_date、user_id、task_id 等），但分属不同数据表。此时直接使用 |（OR）操作符会报错：TypeError: Cannot combine queries on different base models，因为该操作仅适用于同一模型的 QuerySet。
正确方案是使用 Django 2.0+ 引入的 union() 方法：
from django.db import models
# 获取两个模型的有序 QuerySet（注意：union 前需先 .values() 或确保字段完全一致）
qs_a = ProgramAAssignments.objects.all().values(
'id', 'user_id', 'task_id', 'assignment_date', 'status'
).order_by('-assignment_date')
qs_b = ProgramBAssignments.objects.all().values(
'id', 'user_id', 'task_id', 'assignment_date', 'status'
).order_by('-assignment_date')
# 合并结果（all=True 保留重复项；省略则自动去重）
combined_qs = qs_a.union(qs_b, all=True)⚠️ 关键注意事项：
union() 要求所有 QuerySet 的 .values() 字段数量、顺序、类型必须严格一致（Django 不做隐式转换）；
order_by() 必须在 union() 之后调用，否则会被忽略（Django 会抛出 FieldError）；
-
union() 返回的是 ValuesQuerySet（字典列表），不再返回模型实例；若需模型对象，应改用 itertools.chain() + 手动排序（性能较低，仅适用于小数据集）：
from itertools import chain from operator import attrgetter combined_list = sorted( chain(ProgramAAssignments.objects.all(), ProgramBAssignments.objects.all()), key=attrgetter('assignment_date'), reverse=True ) union() 底层生成 SQL UNION ALL（all=True）或 UNION（默认去重），效率远高于 Python 层合并，推荐用于中大型数据集。
总结：对于同构异表合并，优先使用 union() 配合 .values()；若必须保留模型实例且数据量可控，可选 itertools.chain()；切勿误用 | 操作符跨模型合并。此方案既保持数据库零改动，又实现视图逻辑统一，是维护型项目升级的经典实践。
