Django 信号机制详解：内置信号注册与自定义信号实现

清欢

发布时间：2026-10-13| 4人浏览过

原创

本文详细介绍 Django 框架中的信号调度机制，涵盖内置信号的分类与触发时机，以及如何通过定义 Signal 类、注册回调函数和手动触发来创建自定义信号。结合日志记录实战案例，演示如何利用 pre_save 和 post_save 信号实现数据操作前后的自动化处理，帮助开发者更好地解耦代码逻辑。

Django 信号机制概述

前言

Django 框架内置了“信号调度”功能，旨在实现框架执行操作时的模块解耦。简单来说，当特定动作发生时，信号机制允许特定的发送者通知相关的接收者，从而实现事件驱动的处理流程。

Django 内置信号详解

1、Django 内置信号


Model signals
  pre_init          # django的modal执行其构造方法前，自动触发
  post_init          # django的modal执行其构造方法后，自动触发
  pre_save          # django的modal对象保存前，自动触发
  post_save          # django的modal对象保存后，自动触发
  pre_delete         # django的modal对象删除前，自动触发
  post_delete         # django的modal对象删除后，自动触发
  m2m_changed         # django的modal中使用m2m字段操作第三张表（add,remove,clear）前后，自动触发
  class_prepared       # 程序启动时，检测已注册的app中modal类，对于每一个类，自动触发
Management signals
  pre_migrate         # 执行migrate命令前，自动触发
  post_migrate        # 执行migrate命令后，自动触发
Request/response signals
  request_started       # 请求到来前，自动触发
  request_finished      # 请求结束后，自动触发
  got_request_exception    # 请求异常后，自动触发
Test signals
  setting_changed       # 使用test测试修改配置文件时，自动触发
  template_rendered      # 使用test测试渲染模板时，自动触发
Database Wrappers
  connection_created     # 创建数据库连接时，自动触发

对于 Django 提供的内置信号，开发者只需注册对应的信号处理器。当程序执行到相应的操作节点时，系统会自动触发已注册的函数。


from django.core.signals import request_finished
  from django.core.signals import request_started
  from django.core.signals import got_request_exception

  from django.db.models.signals import class_prepared
  from django.db.models.signals import pre_init, post_init
  from django.db.models.signals import pre_save, post_save
  from django.db.models.signals import pre_delete, post_delete
  from django.db.models.signals import m2m_changed
  from django.db.models.signals import pre_migrate, post_migrate

  from django.test.signals import setting_changed
  from django.test.signals import template_rendered

  from django.db.backends.signals import connection_created


  def callback(sender, **kwargs):
    print("xxoo_callback")
    print(sender,kwargs)

  xxoo.connect(callback)
  # xxoo指上述导入的内容


from django.core.signals import request_finished
from django.dispatch import receiver

@receiver(request_finished)
def my_callback(sender, **kwargs):
  print("Request finished!")

自定义信号的创建与使用

2、自定义信号

a. 定义信号


import django.dispatch
pizza_done = django.dispatch.Signal(providing_args=["toppings", "size"])

b. 注册信号


def callback(sender, **kwargs):
  print("callback")
  print(sender,kwargs)
 
pizza_done.connect(callback)

c. 触发信号


from 路径 import pizza_done
 
pizza_done.send(sender='seven',toppings=123, size=456)

内置信号的触发器已集成在 Django 内部，因此会自动调用。而自定义信号则需要开发者在代码的任意位置手动触发，以执行特定的业务逻辑。

实战案例：基于信号的日志记录

需求场景：

每当向数据库表中新增一条数据时，自动记录一条操作日志。

django_signals/__init__.py


from django.db.models import signals

def before_save1(*args,**kwargs):
  print('有车来了，我要服务了--》',args,kwargs)

def before_save2(*args,**kwargs):
  print('有车来了，我要服务了--》',args,kwargs)

def after_save1(*args,**kwargs):
  print('有车来了，完事了--》',args,kwargs)

# 增加之前
signals.pre_save.connect(before_save1)
signals.pre_save.connect(before_save2)
# 增加之后
signals.post_save.connect(after_save1)

django_signals/__init__.py

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持本站。