解耦Django信号与依赖数据库的类，解决makemigrations报错

这是Django开发中很常见的启动阶段依赖冲突问题——迁移命令执行时，数据库结构还未就绪，但ready()函数里的逻辑却试图访问数据库，直接导致报错。下面给你几个靠谱的解决方案：

方案一：懒加载Recommender实例（最通用） #

核心思路是不在模块导入时创建object_y，而是等到第一次真正需要使用它的时候（也就是信号触发时）再初始化，同时加线程锁避免多线程环境下重复创建。这样迁移命令执行时，因为信号不会被触发，就不会走到数据库查询的逻辑。

修改你的代码如下：

# 原来创建object_y的文件
import threading
from .models import LocationNode

class Recommender: 
    def __init__(self): 
        self.location_ids = self.get_location_ids() 
        self.heavy_object1 = self.compute_heavy_object1(self.location_ids) 
        self.heavy_object2 = self.compute_heavy_object2(..., self.location_ids) 

    def get_location_ids(self): 
        locations = LocationNode.objects.filter(level=1, parent_id=1) 
        return [location.id for location in locations] 

# 替换直接实例化的代码，改用懒加载函数
_object_y = None
_lock = threading.Lock()

def get_recommender():
    global _object_y
    # 加锁保证多线程下只会初始化一次
    with _lock:
        if _object_y is None:
            _object_y = Recommender()
    return _object_y

然后修改接收器：

@receiver(signal_x, dispatch_uid="update_state") 
def recompute(sender, **kwargs): 
    client_id = kwargs['client_id'] 
    # 第一次调用时才会初始化Recommender
    heavy_recompute(get_recommender(), client_id)

这个方案的优势是完全不依赖命令判断，不管是迁移、shell还是正常运行，都能安全工作，而且保证heavy_object1/2只会被初始化一次，常驻内存。

方案二：在ready()中跳过迁移命令 #

另一种思路是在App的ready()函数里判断当前执行的命令，如果是迁移相关的命令（makemigrations、migrate等），就不导入接收器文件，自然也就不会初始化object_y。

修改apps.py：

from django.apps import AppConfig
import sys

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

    def ready(self):
        # 定义需要跳过的迁移相关命令
        migration_commands = {'makemigrations', 'migrate', 'showmigrations', 'sqlmigrate'}
        # 检查当前执行的命令（sys.argv[1]是manage.py后的第一个参数）
        if len(sys.argv) > 1 and sys.argv[1] not in migration_commands:
            # 只有非迁移命令时才导入接收器
            import your_app.signal_receivers

这个方案更直接，适合场景简单的情况，但要注意：如果是通过其他方式触发ready()（比如某些第三方插件），或者命令参数比较特殊（比如用manage.py runserver --noreload），可能需要调整判断逻辑，但对于常规的迁移操作完全够用。

方案三：用post_migrate信号延迟初始化（适合迁移后预热） #

如果你的heavy_object1/2需要在迁移完成后就预热好，可以结合post_migrate信号来初始化，同时配合命令判断：

# apps.py
from django.apps import AppConfig
from django.db.models.signals import post_migrate
import sys

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

    def ready(self):
        # 绑定post_migrate信号，迁移完成后初始化
        post_migrate.connect(self.initialize_recommender, sender=self)

    def initialize_recommender(self, **kwargs):
        # 同样跳过迁移命令的情况，避免重复初始化
        migration_commands = {'makemigrations', 'migrate'}
        if len(sys.argv) > 1 and sys.argv[1] not in migration_commands:
            from .recommender import get_recommender
            # 触发初始化，完成预热
            _ = get_recommender().location_ids

这个方案本质上是方案一和方案二的结合，适合需要在服务启动后立刻预热的场景，确保第一次信号触发时不会有延迟。

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