Django抽象模型类中如何设置ForeignKey的related_name避免冲突

Django抽象模型的外键字段反向关联名冲突是高频问题，不需要手动给每个子类单独重写字段，框架本身提供了专属占位符语法，可以动态生成适配每个子类的related_name，从根源避免重名冲突。

你只需要把硬编码的related_name替换成包含%(class)s和%(app_label)s占位符的字符串即可，修改后的抽象模型代码如下：

class AbstractModel(models.Model):
    created_at = models.DateTimeField(
        auto_now_add=True,
        blank=True,
        null=True,
    )
    created_by = models.ForeignKey(
        settings.AUTH_USER_MODEL,
        on_delete=models.SET_NULL,
        # 用占位符动态生成每个子类独有的反向关联名
        related_name='%(app_label)s_%(class)s_created_by',
        blank=True,
        null=True,
    )

    class Meta:
        abstract = True

占位符规则说明 #

两个占位符会在子类定义时自动替换为对应值，完全不需要额外手动配置：

• %(class)s：替换为当前子类模型名的小写形式，比如子类是Post就会替换为post
• %(app_label)s：替换为子类所在应用的小写app名称，比如子类在blog应用下就会替换为blog

举个实际例子：如果你的blog应用下有Post模型继承了上述抽象基类，created_by字段对应的User模型反向关联名会自动生成为blog_post_created_by；如果是shop应用下的Order模型继承，反向关联名则为shop_order_created_by，不会出现重名冲突。

如果你不需要从User模型反向查询关联的子类记录，也可以直接把related_name设为'+'，直接关闭反向关联，也不会产生冲突，但绝大多数场景下用占位符生成动态关联名是更灵活的选择。

注意：该占位符语法仅在抽象基类的字段上生效，不要在非抽象的普通父模型、多表继承场景下使用。

内容的提问来源于stack exchange，提问作者Vit Amin