Django模型动态设置自定义管理器调用默认方法报错

错误原因 #

直接通过setattr给模型赋值已实例化的管理器时，Django没有完成管理器与模型的绑定过程——管理器的_model属性会是None。当执行查询方法（如all()）时，Django需要通过管理器获取关联的模型类，此时因_model为None，导致查询内部逻辑抛出TypeError。

修复方案 #

方案1：使用模型的add_to_class方法（推荐） #

Django的模型类提供了add_to_class方法，会自动处理管理器与模型的绑定逻辑，包括设置_model属性、注册管理器到模型内部列表等。修改后的代码如下：

class CustomManager(models.Manager):
    def active(self):
        return self.filter(name__startswith='c')


def set_custom_manager(model_class, manager_class=CustomManager, manager_name='objects'):
    # 使用add_to_class添加管理器，自动完成绑定
    model_class.add_to_class(manager_name, manager_class())
    return model_class


class Facility(BaseModel):
    name = models.CharField(_("Name"), max_length=255)
    icon = models.ImageField(upload_to='location/facilities/')
    order = models.PositiveIntegerField(_("Order"), default=0)

    class Meta:
        verbose_name = _("Facility")
        verbose_name_plural = _("Facilities")
        ordering = ['order', 'id']

    def __str__(self):
        return self.name

# 调用时传入管理器类即可（或不传，使用默认的CustomManager）
set_custom_manager(Facility)

方案2：手动绑定管理器的_model属性 #

如果坚持使用setattr，需要手动将管理器的_model属性指向目标模型类：

def set_custom_manager(model_class, manager=CustomManager(), manager_name='objects'):
    # 手动绑定模型到管理器
    manager._model = model_class
    setattr(model_class, manager_name, manager)
    return model_class

# 调用方式不变
set_custom_manager(Facility, CustomManager())

注意：原函数的默认参数manager=CustomManager()存在隐患——函数定义时会提前实例化一次管理器，所有未传manager参数的调用都会共享同一个实例，可能引发意外问题。推荐方案1的写法，将默认参数设为管理器类，在函数内部实例化。

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