Django自定义models.Manager查询时Inactive_Date字段未定义如何解决

问题根因 #

你遇到的Inactive_Date未定义报错、自定义管理器不生效，核心是Django ORM的filter方法语法使用错误，和管理器定义在Animal类内部还是外部没有关联：

• filter内筛选字段不能直接写字段名 == 值的表达式，这种写法会被Python先尝试解析当前作用域下的Inactive_Date变量，该变量不存在自然抛出未定义错误。
• ORM筛选字段需要以关键字参数的形式传递，键为字段名（对应筛选规则），值为匹配条件，空值判断统一使用__isnull=True的官方推荐语法。

修正后的代码 #

import datetime
from django.db import models
# 可选引入，用于适配项目时区设置
from django.utils import timezone

class AnimalManager(models.Manager):
    def get_queryset(self):
        # 修正filter写法，用__isnull判断空值
        return super().get_queryset().filter(Inactive_Date__isnull=True)
        
class Animal(models.Model):
    Name = models.CharField(max_length=64, unique=True)
    Inactive_Date = models.DateField(null=True, blank=True)
    # 外键关联模型如果定义在当前类之后，用字符串引用避免未定义错误
    Animal_Type = models.ForeignKey('Animal_Type', null=True, on_delete=models.SET_NULL, default=None)
    Comments = models.CharField(max_length=255, blank=True)
    
    def __str__(self) -> str:
        return self.Name
    
    def delete(self):
        # 时区兼容写法替换：self.Inactive_Date = timezone.now().date()
        self.Inactive_Date = datetime.date.today()
        self.save()
    
    objects = AnimalManager() # 默认仅返回未软删除的条目
    # 可选补充全量管理器，需要查已软删除数据时调用Animal.all_objects.all()
    all_objects = models.Manager()

额外注意点 #

• 上述软删除逻辑仅对单实例delete()方法生效，如果需要支持批量删除的软删除逻辑，需要额外重写管理器的批量删除方法。
• 如果要实现关联数据的级联软删除，需要额外配置信号或者重写关联模型的删除逻辑。

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