django-simple-history排除last_login字段历史追踪问题及优化需求

你遇到的是django-simple-history的典型行为：即便通过excluded_fields排除了字段，只要模型实例被保存（比如登录时更新last_login），还是会生成一条空字段的历史记录。要彻底避免这类冗余数据生成，有几个更优的解决方案：

方案1：在CustomUser的save方法中控制历史记录生成 #

重写模型的save方法，判断是否仅last_login字段发生变更，若是则跳过历史记录创建：

from django.contrib.auth.models import AbstractUser
from simple_history.models import HistoricalRecords

class CustomUser(AbstractUser):
    history = HistoricalRecords(excluded_fields=['last_login'])

    def save(self, *args, **kwargs):
        if self.pk:
            original = CustomUser.objects.get(pk=self.pk)
            changed_fields = []
            # 对比所有字段，找出变更项
            for field in self._meta.fields:
                if getattr(self, field.name) != getattr(original, field.name):
                    changed_fields.append(field.name)
            # 仅当last_login变更时，设置跳过历史的标记
            if changed_fields == ['last_login']:
                self.skip_history_when_saving = True
        super().save(*args, **kwargs)
        # 重置标记，避免影响后续保存操作
        if hasattr(self, 'skip_history_when_saving'):
            delattr(self, 'skip_history_when_saving')

方案2：在登录逻辑中临时跳过历史记录 #

如果使用自定义登录逻辑，可在更新last_login时给用户实例添加跳过标记：

from django.contrib.auth import authenticate, login

def custom_login(request):
    # ... 认证逻辑 ...
    user = authenticate(request, username=username, password=password)
    if user is not None:
        # 临时设置跳过历史标记
        user.skip_history_when_saving = True
        login(request, user)  # login方法会自动更新last_login并保存用户
        # 移除标记，不影响后续操作
        delattr(user, 'skip_history_when_saving')

若用Django默认的LoginView，可以继承并重写form_valid方法实现同样逻辑。

方案3：自定义历史信号处理器 #

django-simple-history通过post_save信号触发历史记录创建，可替换默认处理器，过滤掉仅last_login变更的情况：

from django.db.models.signals import post_save
from simple_history.signals import post_save_history
from .models import CustomUser

# 先断开默认的信号连接
post_save.disconnect(post_save_history, sender=CustomUser)

def custom_post_save_history(sender, instance, created, **kwargs):
    # 新建实例不处理，仅更新时检查变更字段
    if not created:
        original = sender.objects.get(pk=instance.pk)
        changed_fields = []
        for field in instance._meta.fields:
            if getattr(instance, field.name) != getattr(original, field.name):
                changed_fields.append(field.name)
        # 仅last_login变更则跳过历史记录
        if changed_fields == ['last_login']:
            return
    # 调用原处理器逻辑处理其他变更
    post_save_history(sender, instance, created, **kwargs)

# 连接自定义信号处理器
post_save.connect(custom_post_save_history, sender=CustomUser)

三个方案各有侧重：方案1覆盖所有仅更新last_login的场景，通用性最强；方案2精准针对登录场景；方案3从全局信号层面统一控制，适合需要批量处理的情况。

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