Django中自动生成各model关联历史model的实现问询

当然可以实现！这种重复写样板代码的场景，用Django的元类或者动态模型生成就能完美解决，完全不用手动逐个创建历史模型。下面给你两种实用的方案，都是Django开发者常用的思路：

这种方式最省心，能在你定义业务模型时自动同步创建对应的历史模型，逻辑完全封装在底层，业务代码里几乎不用额外写东西。

首先定义一个抽象的历史模型基类，包含所有历史记录需要的通用字段：

from django.db import models
from django.utils.timezone import now

class BaseHistoryModel(models.Model):
    # 通用历史字段：变更时间、操作人、变更类型
    changed_at = models.DateTimeField(default=now)
    changed_by = models.ForeignKey(
        'auth.User',
        on_delete=models.SET_NULL,
        null=True,
        related_name='%(class)s_changes'
    )
    change_type = models.CharField(max_length=20, choices=[
        ('create', '创建'),
        ('update', '更新'),
        ('delete', '删除'),
    ])

    class Meta:
        abstract = True

然后写一个元类，用来自动为每个业务模型生成对应的历史模型：

class HistoryModelMetaclass(models.base.ModelBase):
    def __new__(cls, name, bases, attrs):
        # 先创建业务模型本身
        model = super().__new__(cls, name, bases, attrs)
        # 跳过抽象模型和历史模型本身，避免循环创建
        if model._meta.abstract or name.endswith('History'):
            return model
        
        # 构造历史模型的类名（比如User -> UserHistory）
        history_model_name = f"{name}History"
        # 定义历史模型的核心属性：添加指向业务模型的外键
        history_attrs = {
            'related_model': models.ForeignKey(
                model,
                on_delete=models.CASCADE,
                related_name='history_records'
            ),
            '__module__': model.__module__,
            'Meta': type('Meta', (), {'abstract': False})
        }
        # 动态创建历史模型类
        history_model = cls(history_model_name, (BaseHistoryModel,), history_attrs)
        # 把历史模型绑定到业务模型上，方便后续调用
        setattr(model, 'HistoryModel', history_model)
        
        return model

最后，让你的业务抽象基类使用这个元类：

class YourAbstractBaseModel(models.Model, metaclass=HistoryModelMetaclass):
    # 这里放你的业务基类通用字段，比如创建时间、状态等
    created_at = models.DateTimeField(default=now)

    class Meta:
        abstract = True

现在只要你的业务模型继承YourAbstractBaseModel，比如：

class Product(YourAbstractBaseModel):
    name = models.CharField(max_length=100)
    price = models.DecimalField(max_digits=10, decimal_places=2)

系统会自动生成ProductHistory模型——它包含changed_at、changed_by、change_type字段，还有指向Product的外键related_model。同时Product会有history_records反向关联，你可以直接用product.history_records.all()查看该产品的所有变更记录。

如果觉得元类有点抽象，也可以用「抽象历史模型+App启动时动态生成」的方式，逻辑更直观，适合新手理解。

首先还是定义通用的抽象历史模型：

class BaseHistoryModel(models.Model):
    changed_at = models.DateTimeField(default=now)
    changed_by = models.ForeignKey('auth.User', on_delete=models.SET_NULL, null=True)
    change_type = models.CharField(max_length=20, choices=[('create', '创建'), ('update', '更新'), ('delete', '删除')])

    class Meta:
        abstract = True

然后写一个函数，用来动态生成指定业务模型的历史模型：

def create_history_model(model):
    history_model_name = f"{model.__name__}History"
    # 动态构造历史模型类
    history_model = type(
        history_model_name,
        (BaseHistoryModel,),
        {
            'related_model': models.ForeignKey(
                model,
                on_delete=models.CASCADE,
                related_name='history_records'
            ),
            '__module__': model.__module__,
            'Meta': type('Meta', (), {'db_table': f"{model._meta.db_table}_history"})
        }
    )
    return history_model

接下来，在你的app的apps.py里，通过ready()方法自动为所有业务模型创建历史模型：

from django.apps import AppConfig
from django.db import models
from .models import YourAbstractBaseModel

class YourAppConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'your_app'

    def ready(self):
        # 遍历所有继承自YourAbstractBaseModel的非抽象模型
        for model in models.get_models():
            if issubclass(model, YourAbstractBaseModel) and not model._meta.abstract:
                # 创建并注册历史模型
                create_history_model(model)

别忘了在settings.py里把app配置换成这个自定义的Config哦。

额外加分：自动记录变更 #

生成历史模型后，还可以用Django信号自动记录增删改操作，比如：

from django.db.models.signals import post_save, post_delete
from django.dispatch import receiver

@receiver(post_save)
def log_create_update(sender, instance, created, **kwargs):
    # 跳过历史模型和抽象模型
    if sender._meta.abstract or sender.__name__.endswith('History'):
        return
    # 获取对应的历史模型
    history_model = sender.HistoryModel if hasattr(sender, 'HistoryModel') else create_history_model(sender)
    # 记录变更类型
    change_type = 'create' if created else 'update'
    # 创建历史记录（如果需要记录当前用户，可以结合django-request等库获取）
    history_model.objects.create(
        related_model=instance,
        change_type=change_type,
        # changed_by=request.user  # 需要中间件配合获取当前用户
    )

@receiver(post_delete)
def log_delete(sender, instance, **kwargs):
    if sender._meta.abstract or sender.__name__.endswith('History'):
        return
    history_model = sender.HistoryModel if hasattr(sender, 'HistoryModel') else create_history_model(sender)
    history_model.objects.create(
        related_model=instance,
        change_type='delete',
        # changed_by=request.user
    )

这样每次业务模型的增删改都会自动生成历史记录，彻底解放双手~

两种方案都能帮你消除样板代码，元类方案更适合在模型定义时同步完成创建，动态模型方案更灵活，适合后期扩展。你可以根据项目复杂度选择~

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