Django信号机制：原理、内置信号与自定义应用

落日邮差

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

原创

本文深入解析Django的信号机制，阐述其基于观察者模式的工作原理。详细介绍pre_save、post_save等内置信号的使用场景，并通过代码示例演示如何注册回调函数。重点讲解利用receiver装饰器简化注册过程，以及如何在自定义信号中处理sender、instance等参数，实现如订单状态联动更新等复杂业务逻辑。

Django提供了一套信号机制，其本质是观察者模式，也常被称为发布-订阅（Publish/Subscribe）模式。当系统中发生特定动作时，会触发信号发送，所有监听该信号的函数随即执行相应的处理逻辑。

Django框架内置了多种常用信号，主要包括：

django.db.models.signals.pre_save 在某个Model保存之前调用
django.db.models.signals.post_save 在某个Model保存之后调用
django.db.models.signals.pre_delete 在某个Model删除之前调用
django.db.models.signals.post_delete 在某个Model删除之后调用
django.core.signals.request_started 在建立Http请求时发送
django.core.signals.request_finished 在关闭Http请求时发送

开发者需要做的核心工作是注册一个接收器（receiver）函数。例如，若需要在每次HTTP请求处理完毕后打印一行日志，可以通过以下方式实现。

可以使用传统的connect方法进行注册：

# receiver
def my_callback(sender, **kwargs):
  print("Request finished!")
 
# connect
from django.core.signalsimport request_finished
 
request_finished.connect(my_callback)

此外，还可以采用装饰器方式进行注册，以下代码与上述connect方式功能完全等价。

from django.core.signalsimport request_finished
from django.dispatchimport receiver
 
@receiver(request_finished)
def my_callback(sender, **kwargs):
  print("Request finished!")

receiver回调函数除了接收sender参数外，还可接收其他特定参数。以pre_save信号为例，其回调函数可接收以下参数：

sender：信号发送者（对于pre_save而言，即对应的Model类） instance：模型实例 raw：原始数据 using：数据库别名 update_fields：更新的字段列表 post_save信号则更为实用，常用于处理联动更新逻辑，避免在View层重复编写代码。例如，当用户提交退款申请时，需将关联订单的状态更新为“已退款”，此时利用信号机制即可自动完成状态变更，无需在每一处业务代码中手动修改。

@receiver(post_save, sender=RefundForm)
deforder_state_update(sender, instance, created, **kwargs):
  instance.order.state = REFUNDING
  instance.order.save() # 这里，order是refundform的一个外键

当然，实际开发中逻辑可进一步细化，例如处理退款单取消时，需将状态恢复为原状等更周全的场景。

观察者模式在实际应用中极具价值，Django同样支持用户自定义信号，以满足特定业务需求。