本文介绍如何无需硬编码每个外键或 M2M 字段，即可动态获取 Person 查询集及其全部正向/反向关联对象（如 Hobby、TShirt、Shirt、Shoes），通过元数据扫描与 prefetch_related 实现全自动关系展开。
本文介绍如何无需硬编码每个外键或 m2m 字段，即可动态获取 person 查询集及其全部正向/反向关联对象（如 hobby、tshirt、shirt、shoes），通过元数据扫描与 `prefetch_related` 实现全自动关系展开。
在 Django 开发中，常需从一个模型（如 Person）出发，一次性加载其所有关联数据以避免 N+1 查询问题。但当关联模型较多（如 Hobby、TShirt、Shirt、Shoes）且可能随业务扩展新增时，手动为每个 related_name 编写 Prefetch 显得冗余且易遗漏。
Django 的模型元数据系统提供了可靠的自动化基础：model._meta.get_fields() 可遍历所有字段和关系描述符。我们可据此筛选出所有 ManyToOneRel（即外键反向关系）和 ManyToManyRel（含正向/反向 M2M），并统一生成 prefetch_related 所需的 Prefetch 对象。
以下是一个健壮、可复用的工具函数：
from django.db import models
def get_all_prefetches(model, exclude_hidden=True):
"""
自动获取 model 所有非隐藏的正向/反向一对多、多对多关系的 Prefetch 配置。
返回 Prefetch 实例列表，适用于 prefetch_related(*result)。
"""
prefetches = []
for field in model._meta.get_fields():
# 过滤掉普通字段、一对一正向关系、隐藏字段（如内部反向关系）
if exclude_hidden and field.is_hidden:
continue
if isinstance(field, (models.ManyToOneRel, models.ManyToManyRel)):
# 使用 related_name（若存在），否则 fallback 到字段名 + '_set'
lookup = getattr(field, 'related_name', None) or f"{field.field.name}_set"
# 为避免属性名冲突，to_attr 使用更明确的命名约定
to_attr = f"{lookup.rstrip('_set')}_list" if lookup.endswith('_set') else f"{lookup}_list"
prefetches.append(models.Prefetch(lookup=lookup, to_attr=to_attr))
return prefetches
使用方式简洁清晰：
# 动态构建 prefetch 配置
prefetch_configs = get_all_prefetches(Person)
# 应用于查询集（支持链式调用）
persons = (
Person.objects
.prefetch_related(*prefetch_configs)
.order_by('-created_at')[:4]
)
# 访问预取结果（无数据库查询）
for p in persons:
print(f"Person: {p.name}")
print(f"→ Hobbies: {[h.name for h in getattr(p, 'hobbies_list', [])]}")
print(f"→ T-Shirts: {[t.name for t in getattr(p, 'tshirts_list', [])]}")
print(f"→ Shirts: {[s.name for s in getattr(p, 'shirts_list', [])]}")
print(f"→ Shoes: {[s.name for s in getattr(p, 'shoes_list', [])]}")
⚠️ 注意事项：
- 该方法不包含 OneToOneRel（一对一正向关系），因其通常需显式控制；如需支持，可扩展判断逻辑。
-
related_name为+（即禁用反向关系）或未定义时，get_fields()可能返回无related_name的ManyToOneRel，此时使用field.field.name + '_set'是安全 fallback。 -
to_attr命名采用_list后缀，确保与原始related_name区分，避免覆盖模型方法或属性。 - 若性能敏感，建议结合
only()/defer()控制主表字段加载，并对大数据量关联表考虑Prefetch(queryset=Model.objects.only(...))优化。
总结而言，相比逐个硬编码 Prefetch('hobbies')、Prefetch('tshirts') 等，此方案将关系发现逻辑交给 Django 元数据，既符合 DRY 原则，又具备良好可维护性与可扩展性——新增一个指向 Person 的外键模型后，只需确保设置合理的 related_name，无需修改预取逻辑即可自动生效。
