### Django 自动操作日志功能实现 要在 Django 中实现自动化的操作日志功能，可以通过以下方法完成： #### 1. 创建操作日志模型 首先，在 `models.py` 文件中定义一个用于存储操作日志的数据库表。该表应该包含必要的字段以记录每次操作的相关信息。 ```python from django.db import models from django.contrib.auth.models import User class OperationLog(models.Model): user = models.ForeignKey(User, on_delete=models.SET_NULL, null=True, blank=True) # 记录执行操作的用户 action = models.CharField(max_length=255) # 操作描述 model_name = models.CharField(max_length=255) # 修改的数据模型名 object_id = models.PositiveIntegerField(null=True, blank=True) # 修改的对象ID changes = models.JSONField(default=dict) # 字段变化前后的对比 created_at = models.DateTimeField(auto_now_add=True) # 日志创建时间 def __str__(self): return f"{self.user} performed {self.action} at {self.created_at}" ``` 此模型设计涵盖了常见的日志需求[^1]，并支持 JSON 格式的字段变化记录。 --- #### 2. 使用信号监听数据修改事件 为了在数据被修改时自动生成日志，可以利用 Django 提供的 **signals** 功能。具体来说，可以在 `signals.py` 或者应用初始化模块中注册 `post_save` 和 `pre_delete` 信号。 以下是基于 `post_save` 的示例代码： ```python import json from django.db.models.signals import post_save, pre_delete from django.dispatch import receiver from .models import OperationLog @receiver(post_save) def log_model_changes(sender, instance, created, **kwargs): if sender._meta.app_label != 'your_app': # 替换为实际的应用名称 return if not hasattr(instance, '_original_state'): original_data = {} else: original_data = instance._original_state current_data = { field.name: getattr(instance, field.name) for field in sender._meta.fields } changes = {} for key in set(original_data.keys()).union(current_data.keys()): old_value = original_data.get(key) new_value = current_data.get(key) if old_value != new_value: changes[key] = {"old": str(old_value), "new": str(new_value)} if changes or created: operation_log = OperationLog( user=getattr(instance, 'created_by', None), action="Created" if created else "Updated", model_name=sender.__name__, object_id=instance.id, changes=json.dumps(changes) ) operation_log.save() ``` 在此基础上，还需要在视图层保存原始状态以便比较差异： ```python from django.shortcuts import get_object_or_404 from your_app.models import YourModel def update_view(request, pk): obj = get_object_or_404(YourModel, id=pk) # 将对象当前状态存入临时属性 setattr(obj, '_original_state', {field.name: getattr(obj, field.name) for field in obj._meta.fields}) # 更新逻辑... ``` --- #### 3. 整合日志配置至 settings.py 为了让日志更加灵活可控，需调整项目的全局日志设置。例如，仅将特定级别的消息输出到文件或控制台。 ```python LOGGING = { 'version': 1, 'disable_existing_loggers': False, 'handlers': { 'file': { 'level': 'INFO', 'class': 'logging.FileHandler', 'filename': 'operation_logs.log', }, 'console': { 'level': 'DEBUG', 'class': 'logging.StreamHandler', } }, 'loggers': { 'django': { 'handlers': ['file'], 'level': 'INFO', 'propagate': True, }, 'custom_logger': { 'handlers': ['console'], 'level': 'DEBUG', 'propagate': True, } }, } ``` 上述配置允许开发者自由切换日志目标位置[^4]，从而满足不同环境下的调试与监控需求。 --- #### 4. 插件化扩展 (可选方案) 如果希望减少重复开发工作量，则推荐使用第三方库如 [django-simple-history](https://github.com/jazzband/django-simple-history)，它能够轻松追踪模型实例的历史版本，并兼容 Admin 后台管理界面[^2]。 安装命令如下： ```bash pip install django-simple-history ``` 随后只需继承其提供的基类即可启用历史跟踪功能： ```python from simple_history.models import HistoricalRecords class ExampleModel(models.Model): name = models.CharField(max_length=100) history = HistoricalRecords() def __str__(self): return self.name ``` --- ### 总结 以上介绍了两种主要途径来实现在 Django 应用程序内的自动化操作日志记录机制——一种是从零构建完整的解决方案；另一种则是借助成熟的开源工具快速部署所需功能。无论采用哪种方式，均能有效提升系统的透明度和审计能力。