Django 4.2：多模型关联单个文档模型的最佳实践

针对你遇到的问题，**通用外键（Generic Foreign Key）**是Django官方推荐的解决方案，能有效避免冗余字段和重复表结构的问题。

实现步骤 #

1. 导入通用外键所需模块
2. 为业务模型添加反向关联字段GenericRelation
3. 修改Document模型，使用通用外键核心字段

完整代码示例：

from django.db import models
from django.contrib.contenttypes.models import ContentType
from django.contrib.contenttypes.fields import GenericForeignKey, GenericRelation

# 业务模型
class MyModel(models.Model):
    # 自定义业务字段，示例省略
    documents = GenericRelation('Document')  # 反向关联，支持从实例直接获取文档

class MySecondModel(models.Model):
    # 自定义业务字段，示例省略
    documents = GenericRelation('Document')

class MyThirdModel(models.Model):
    # 自定义业务字段，示例省略
    documents = GenericRelation('Document')

# 文档模型
class Document(models.Model):
    name = models.CharField(max_length=255)
    file = models.FileField(upload_to='documents/')
    
    # 通用外键核心字段
    content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE)
    object_id = models.PositiveIntegerField()
    content_object = GenericForeignKey('content_type', 'object_id')

使用方式 #

• 关联文档到业务模型实例：

# 获取业务模型实例
my_model_instance = MyModel.objects.get(pk=1)
# 创建并关联文档
Document.objects.create(
    name="项目需求文档",
    file=open("requirements.pdf", "rb"),
    content_object=my_model_instance
)

• 从业务模型实例获取关联文档：

my_model_instance = MyModel.objects.get(pk=1)
# 获取所有关联文档
docs = my_model_instance.documents.all()

优势对比 #

• 无冗余字段：每个Document实例仅存储必要的关联信息，不会出现空外键
• 无需重复建表：所有业务模型共用同一个文档表，避免结构冗余
• 逻辑统一：文档管理逻辑集中在一个模型中，减少重复代码

注意事项 #

• 通用外键不支持数据库级别的外键约束，需在业务逻辑中确保关联对象的有效性
• 如需按业务模型过滤文档，可通过ContentType实现：

from django.contrib.contenttypes.models import ContentType

# 获取MyModel对应的ContentType
my_model_type = ContentType.objects.get_for_model(MyModel)
# 查询所有关联MyModel的文档
my_model_docs = Document.objects.filter(content_type=my_model_type)

内容的提问来源于stack exchange，提问作者Владислав Гнатюк