Django数据库路由allow_migrate报错：缺少app_label参数

问题根源 #

运行python manage.py makemigrations时报错TypeError: allow_migrate() missing 1 required positional argument: 'app_label'，核心原因是你的allow_migrate方法参数签名不符合Django 4.2版本的调用约定。Django在调用该方法时会传入db和app_label两个必填位置参数，若方法定义缺少这两个参数（或参数顺序错误），就会触发此错误。

正确解决方案 #

修改数据库路由类中allow_migrate方法的参数签名，严格遵循Django 4.2的要求，完整签名如下：

def allow_migrate(self, db, app_label, model_name=None, **hints):

完整路由示例（routers.py） #

class CustomDatabaseRouter:
    def db_for_read(self, model, **hints):
        # 自定义读数据库路由逻辑
        return 'default'

    def db_for_write(self, model, **hints):
        # 自定义写数据库路由逻辑
        return 'default'

    def allow_relation(self, obj1, obj2, **hints):
        # 自定义关联允许逻辑
        return True

    def allow_migrate(self, db, app_label, model_name=None, **hints):
        # 自定义迁移允许逻辑，示例：限制特定app的迁移目标数据库
        if app_label == 'myapp':
            return db == 'secondary_db'
        # 返回None表示使用Django默认的迁移规则
        return None

补充说明 #

• 无需将方法改为staticmethod，保持实例方法即可保留self变量，用于访问路由类的其他属性或自定义逻辑。
• 不要注释allow_migrate方法，否则无法自定义迁移规则。
• 确保settings.py中已正确配置路由：

DATABASE_ROUTERS = ['myproject.routers.CustomDatabaseRouter']

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