Django 4.0.7同一主键对应多实例异常问题求助

核心原因 #

你的问题几乎可以确定是django-taggit的TaggableManager引发的笛卡尔积重复。TaggableManager底层基于多对多关联（通过中间表绑定标签），当执行Collection.objects.all()时，若某个Collection关联了多个标签，数据库会返回多条对应同一Collection主键的结果（每条对应一个标签关联），Django ORM默认不会自动去重，因此出现重复实例。

解决方案 #

1. 修复查询重复 #

在查询语句后添加distinct()强制去重：

for c in Collection.objects.all().distinct():
    print(c.pk, c.id)

2. 修复Admin显示重复 #

修改Collection的Admin类，重写get_queryset方法加入去重逻辑：

from django.contrib import admin
from .models import Collection

@admin.register(Collection)
class CollectionAdmin(admin.ModelAdmin):
    def get_queryset(self, request):
        return super().get_queryset(request).distinct()

3. 排查其他可能性 #

• 检查Collection模型是否使用了自定义Manager/QuerySet，是否有逻辑导致查询重复
• 直接查询数据库验证主键唯一性：

  -- 替换yourapp为你的应用名称
  SELECT id, COUNT(*) FROM yourapp_collection GROUP BY id HAVING COUNT(*) > 1;
  

  如果返回结果，说明数据库中确实存在重复主键（这种情况极少，可能是手动修改数据库或极端ORM bug导致），需要手动清理重复数据并检查数据写入逻辑。

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