【后端】【Django】Django 信号（Signals）详解
Django 信号（Signals）详解（循序渐进）一、信号（Signal）概述
1. 什么是 Django 信号？
Django 信号（Signal） 是一种 观察者模式（Observer Pattern） 的实现，允许差别部分的代码在发生特定事件时举行通信，而不必要直接调用。
作用：当某个事件发生时，Django 会自动通知相关的信号处理函数，让它们执行相应的操作。
2. 信号的核心概念
[*]发送者（Sender）：触发信号的对象（一般是 Django 模型）。
[*]信号（Signal）：预定义的信号类型，比方 post_save、pre_delete 等。
[*]接收器（Receiver）：监听信号的函数，接收到信号后执行相应操作。
[*]连接（Connect）：将信号与接收器绑定，使其在事件发生时被触发。
二、Django 内置信号
信号名称触发时机pre_save调用 save() 之前post_save调用 save() 之后pre_delete调用 delete() 之前post_delete调用 delete() 之后m2m_changed多对多字段修改时request_startedHTTP 哀求开始时request_finishedHTTP 哀求结束时got_request_exception视图抛出非常时pre_migrate迁移前post_migrate迁移后 三、信号的根本使用
1. 监听 post_save 信号
场景： 当 User 被创建时，自动创建 Profile。
（1）创建模型
from django.db import models
from django.contrib.auth.models import User
class Profile(models.Model):
user = models.OneToOneField(User, on_delete=models.CASCADE)
bio = models.TextField(blank=True)
（2）在 signals.py 里定义信号
from django.db.models.signals import post_save
from django.dispatch import receiver
from django.contrib.auth.models import User
from .models import Profile
@receiver(post_save, sender=User)
def create_user_profile(sender, instance, created, **kwargs):
"""当用户创建时，自动创建 Profile"""
if created:
Profile.objects.create(user=instance)
[*]@receiver(post_save, sender=User): 监听 User 模型的 post_save 事件。
[*]created=True 时表示 新创建 的用户，此时自动创建 Profile。
（3）注册信号
在 apps.py 里：
from django.apps import AppConfig
class MyAppConfig(AppConfig):
default_auto_field = 'django.db.models.BigAutoField'
name = 'myapp'
def ready(self):
import myapp.signals# 确保信号被加载
四、信号的高级用法
1. 使用 pre_delete 软删除
场景： 当 User 被删除时，不是真正删除，而是标记为已删除。
（1）修改模型
class UserProfile(models.Model):
user = models.OneToOneField(User, on_delete=models.CASCADE)
is_deleted = models.BooleanField(default=False)# 软删除标记
（2）监听 pre_delete
from django.db.models.signals import pre_delete
@receiver(pre_delete, sender=User)
def soft_delete_user(sender, instance, **kwargs):
"""用户删除时，不真正删除，而是标记 is_deleted"""
instance.is_deleted = True
instance.save()
[*]pre_delete 触发时，不直接删除，而是修改 is_deleted。
2. 使用 m2m_changed 监听多对多关系
场景： 监听 Book 和 Author 之间的多对多关系变更。
（1）创建模型
class Author(models.Model):
name = models.CharField(max_length=100)
class Book(models.Model):
title = models.CharField(max_length=200)
authors = models.ManyToManyField(Author)
（2）监听 m2m_changed
from django.db.models.signals import m2m_changed
@receiver(m2m_changed, sender=Book.authors.through)
def book_authors_changed(sender, instance, action, **kwargs):
"""当 Book 的 authors 关系发生变化时触发"""
print(f"Action: {action}, Instance: {instance}")
[*]m2m_changed 触发时，可以获取 action：
[*]pre_add：添加前
[*]post_add：添加后
[*]pre_remove：移除前
[*]post_remove：移除后
[*]pre_clear：清空前
[*]post_clear：清空后
五、手动连接和断开信号
1. 手动连接信号
除了使用 @receiver，我们也可以手动绑定信号：
from django.db.models.signals import post_save
def my_signal_handler(sender, instance, **kwargs):
print(f"{instance} 被保存了！")
post_save.connect(my_signal_handler, sender=User)
优点：
[*]可以在差别的地方注册信号，灵活性更高。
2. 断开信号
偶然我们希望临时关闭某个信号：
post_save.disconnect(my_signal_handler, sender=User)
这样，post_save 信号就不会再触发 my_signal_handler。
六、信号的调试和优化
1. 克制信号循环调用
假如 save() 方法中调用 save()，大概会导致 无限循环：
@receiver(post_save, sender=User)
def create_user_profile(sender, instance, created, **kwargs):
if created:
instance.profile = Profile.objects.create(user=instance)
instance.save()# ⚠️ 这里会导致递归调用
解决方案：
[*]在 save() 方法里 禁用信号：
from django.db.models.signals import post_save
@receiver(post_save, sender=User)
def create_user_profile(sender, instance, created, **kwargs):
if created:
post_save.disconnect(create_user_profile, sender=User)
instance.profile = Profile.objects.create(user=instance)
instance.save()
post_save.connect(create_user_profile, sender=User)
2. 使用 weak=False 克制接收器被垃圾回收
默认环境下，@receiver 使用弱引用，假如接收器没有其他引用，大概会被回收：
post_save.connect(my_signal_handler, sender=User, weak=False)
七、总结
知识点说明post_save在模型 save() 之后触发pre_save在模型 save() 之前触发post_delete在 delete() 之后触发pre_delete在 delete() 之前触发m2m_changed监听多对多关系变更@receiver绑定信号的装饰器connect()手动绑定信号disconnect()手动解绑信号克制循环调用在 save() 里 断开信号 处理 Django 信号提供了强大的事件监听能力，可以资助我们自动执行任务、减少代码耦合，但必要注意克制循环调用、调试信号、提高性能。
页:
[1]