Django post_save信号更新对象时非created分支重复执行两次是什么原因

以下是该问题的三类常见触发原因及对应解决方案：

1. 信号重复注册（最高发原因） #

如果信号接收函数所在的模块被重复导入，@receiver装饰器会为同一个函数多次绑定post_save信号，单次save操作就会触发多次回调。
常见触发场景：

• 信号代码写在models.py等被多处导入的模块中，项目启动时模块被多次加载
• 未遵循Django规范注册信号，没有放在对应app的apps.py的ready方法中初始化

解决方法：

• 将信号逻辑单独存放在app目录下的signals.py文件中
• 在对应app的apps.py的ready方法里导入信号模块，确保仅注册一次：

from django.apps import AppConfig

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

    def ready(self):
        import your_app_name.signals

• 注册信号时添加唯一的dispatch_uid参数，从机制上避免重复绑定：

@receiver(post_save, sender=Post, dispatch_uid="post_save_receiver_unique_id")
def post_save_receiver(sender, instance, created, *args, **kwargs):
    # 原有业务逻辑

2. 业务逻辑中两次调用save()方法 #

单次操作流程中对同一个Post实例调用了两次save方法，自然会触发两次post_save信号。
常见触发场景：

• 调用ModelForm.save(commit=False)手动修改字段后，又额外调用了一次实例的save()方法
• 其他关联信号、中间件、第三方插件中对该实例执行了额外的save操作
• 业务逻辑中存在冗余的save调用

排查方法：
在信号函数中添加调用栈打印，快速定位两次触发的调用来源：

import traceback
@receiver(post_save, sender=Post)
def post_save_receiver(sender, instance, created, *args, **kwargs):
    traceback.print_stack()
    # 原有业务逻辑

3. 开发服务器自动重载机制导致 #

Django原生runserver开发模式默认会启动两个进程：一个监听文件变更负责重载，一个处理业务请求，若信号在两个进程中都被注册就会出现触发两次的情况。
排查方法：
使用python manage.py runserver --noreload关闭自动重载后测试，如果不再重复触发就属于该场景，该问题仅出现在开发环境，生产环境使用uWSGI、Gunicorn等部署时不会出现。

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