Django Taggit查询异常：传入Tag对象却提示需为Photo实例

你定义的Photo模型使用了django-taggit的TaggableManager：

class Photo(models.Model):
    # 其他字段
    tags = TaggableManager(blank=True)

执行以下查询时出现错误：

blue_tag = Tag.objects.get(name='blue')
q1 = Photo.objects.filter(tags=blue_tag)
some_tags = Tag.objects.filter(name__icontains='b')
q1 = Photo.objects.filter(tags__in=some_tags)

错误信息：

Cannot query "blue": Must be "Photo" instance.

错误原因 #

出现这个错误是因为tags是TaggableManager类型，它不是直接的多对多字段，而是通过django-taggit内部的TaggedItem表实现关联。直接写filter(tags=blue_tag)会让Django误解参数类型，以为你要传入Photo实例而非Tag实例，从而抛出类型不匹配的错误。

解决方案 #

办法1：用tags__in过滤（单个/多个标签通用） #

不管是单个Tag对象还是Tag的QuerySet，都用tags__in来过滤，单个Tag需要放进列表里：

# 单个标签查询
blue_tag = Tag.objects.get(name='blue')
q1 = Photo.objects.filter(tags__in=[blue_tag])

# 多个标签查询
some_tags = Tag.objects.filter(name__icontains='b')
q1 = Photo.objects.filter(tags__in=some_tags)

办法2：直接通过标签名查询 #

如果不需要预先获取Tag对象，直接通过标签名称过滤更简单：

# 精准匹配标签名
q1 = Photo.objects.filter(tags__name='blue')

# 模糊匹配标签名
q1 = Photo.objects.filter(tags__name__icontains='b')

办法3：通过TaggedItem关联查询（复杂场景适用） #

如果需要更复杂的关联逻辑，可以直接操作django-taggit的TaggedItem模型：

from taggit.models import TaggedItem
from django.contrib.contenttypes.models import ContentType

blue_tag = Tag.objects.get(name='blue')
# 获取Photo模型的ContentType
photo_content_type = ContentType.objects.get_for_model(Photo)
# 通过TaggedItem关联查询对应的Photo
q1 = Photo.objects.filter(
    id__in=TaggedItem.objects.filter(
        tag=blue_tag,
        content_type=photo_content_type
    ).values_list('object_id', flat=True)
)

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