在 Django 的对象关系映射（ORM）系统中，ForeignKey 字段用于建立模型间的一对多关联。当我们在"多"的一方定义外键指向"一"的一方时，Django 会自动提供从"一"的一方反向访问"多"的一方对象集合的能力。related_name 参数正是用于控制这一反向访问接口的命名。

默认反向关联机制

若在定义外键时未显式声明 related_name，Django 会根据源模型的名称自动生成一个反向管理器。默认格式通常为 <model_name>_set。

以下示例展示了 Customer（客户）与 Order（订单）的关系：

from django.db import models

class Customer(models.Model):
    username = models.CharField(max_length=50)

class Order(models.Model):
    order_no = models.CharField(max_length=100)
    customer = models.ForeignKey(Customer, on_delete=models.CASCADE)

在此结构下，若要获取某位客户名下的所有订单，需使用自动生成的 order_set：

customer = Customer.objects.get(pk=1)
orders = customer.order_set.all()  # 默认反向管理器

自定义反向访问名称

为了提高代码的可读性，建议通过 related_name 指定更具语义化的名称。这允许开发者使用自定义属性名来访问关联对象集合。

class Order(models.Model):
    order_no = models.CharField(max_length=100)
    customer = models.ForeignKey(
        Customer, 
        on_delete=models.CASCADE, 
        related_name='orders'  # 自定义反向名称
    )

配置完成后，反向访问方式变得更加直观：

customer = Customer.objects.get(pk=1)
orders = customer.orders.all()  # 使用自定义名称访问

多对多关系中的应用

related_name 不仅适用于外键，同样适用于 ManyToManyField 和 OneToOneField。在多对多场景中，它定义了从关联模型反向查询当前模型集合的名称。

class Tag(models.Model):
    label = models.CharField(max_length=50)

class Article(models.Model):
    title = models.CharField(max_length=200)
    tags = models.ManyToManyField(Tag, related_name='articles')

通过上述配置，可以通过标签对象直接获取所有关联的文章：

tag = Tag.objects.get(label='django')
articles = tag.articles.all()

related_name 与 related_query_name 的区别

除了控制对象访问属性外，Django 还允许通过 related_query_name 定制反向过滤查询时的字段名称。这在执行跨表查询（如 filter）时非常有用。

class Order(models.Model):
    status = models.CharField(max_length=20)
    customer = models.ForeignKey(
        Customer, 
        on_delete=models.CASCADE, 
        related_name='orders',
        related_query_name='order'  # 定制过滤查询名
    )

当需要查询拥有特定状态订单的客户时，可以使用 related_query_name 指定的名称进行_lookup_：

# 查询所有拥有"已完成"订单的客户
customers = Customer.objects.filter(order__status='completed')

值得注意的是，related_name 决定的是实例属性访问（如 customer.orders），而 related_query_name 决定的是查询表达式中的字段路径（如 order__status）。若未指定 related_query_name，默认情况下其值与 related_name 相同。

命名冲突与唯一性

在同一个模型中，所有反向关系的名称必须保持唯一。如果多个外键字段设置了相同的 related_name，Django 在迁移或运行时会抛出 AccessorCollision 错误。为避免此类问题，建议在大型项目中采用具有命名空间的字符串，例如 'app_label_model_name'，或者使用 + 后缀来显式禁用反向访问（即 related_name='+'），这在不需要反向查询的场景下可以减少内存开销。