Django 4.2：receiver装饰器无法接收自定义信号问题咨询

核心原因 #

你遇到的问题本质是自定义信号发送时未正确传递sender参数，导致与@receiver装饰器中指定的sender不匹配：

• Django内置信号（如pre_delete）触发时，会自动将对应的模型类作为sender传递，所以@receiver指定sender=Demo能精准匹配触发。
• 而你自定义的demo_signal，如果在send_signal方法中发送信号时没有显式指定sender=Demo（比如默认sender为None，或者传递了Demo的实例而非类），那么仅监听sender=Demo的接收器就不会被触发——因为两者的sender不匹配。

解决方法 #

1. 修正信号发送代码 #

发送自定义信号时，必须显式传递sender参数为模型类本身（而非实例）。

示例代码：

# models.py
from django.db import models
from django.dispatch import Signal, receiver

# 定义自定义信号
demo_signal = Signal()

class Demo(models.Model):
    name = models.CharField(max_length=100)

    def send_signal(self):
        # 错误写法：未指定sender，或传递了实例self
        # demo_signal.send(self)
        # 正确写法：指定sender为Demo类
        demo_signal.send(sender=Demo, instance=self)

# 绑定特定sender的接收器
@receiver(demo_signal, sender=Demo)
def signal_handler(sender, instance, **kwargs):
    print(f"自定义信号触发：sender={sender}, instance={instance}")

2. 确保接收器被正确加载 #

如果你的接收器放在单独的signals.py文件中，需要在AppConfig的ready()方法中手动导入，避免Django启动时未注册接收器：

# yourapp/apps.py
from django.apps import AppConfig

class YourAppConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'yourapp'

    def ready(self):
        # 导入信号接收器，确保注册
        import yourapp.signals

同时在settings.py的INSTALLED_APPS中配置该AppConfig：

# settings.py
INSTALLED_APPS = [
    # 其他应用
    'yourapp.apps.YourAppConfig',
]

3. 验证sender匹配逻辑 #

Django信号的sender匹配是严格的：

• 若发送信号时传sender=Demo，只有@receiver中指定sender=Demo的接收器会触发。
• 若发送时传sender=self（Demo实例），则接收器需要指定sender=self.__class__或去掉sender参数才能匹配。

额外排查项 #

• 检查是否存在重复的信号定义，导致接收器连接到了错误的信号实例。
• 确认未使用重复的dispatch_uid参数，避免接收器被覆盖。

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