Django项目迁移报错：GenericForeignKey关联content_type字段异常

问题根源 #

你在TaggedItem模型里犯了字段名冲突的错误：先定义content_type为关联ContentType的ForeignKey，紧接着又用GenericForeignKey()覆盖了这个字段。这导致Django无法识别到content_type是合法的ForeignKey字段，从而触发contenttypes.E003错误。

原错误代码 #

from django.db import models
from django.contrib.contenttypes.models import ContentType
from django.contrib.contenttypes.fields import GenericForeignKey

# Create your models here.
class Tag(models.Model):
    label = models.CharField(max_length=255)
    
class TaggedItem(models.Model):
    # what tag applied to what object 
    tag = models.ForeignKey(Tag, on_delete=models.CASCADE)  
    content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE)
    object_id = models.PositiveIntegerField()  
    content_type = GenericForeignKey()  # 此处覆盖了上方的ForeignKey字段

错误信息 #

SystemCheckError: System check identified some issues:

ERRORS:
like.LikedItem.content_type: (contenttypes.E003) 'LikedItem.content_type' is not a ForeignKey.
        HINT: GenericForeignKeys must use a ForeignKey to 'contenttypes.ContentType' as the 'content_type' field.
tags.TaggedItem.content_type: (contenttypes.E003) 'TaggedItem.content_type' is not a ForeignKey.
        HINT: GenericForeignKeys must use a ForeignKey to 'contenttypes.ContentType' as the 'content_type' field.

解决方案 #

将GenericForeignKey的字段名改为其他名称（比如content_object），并明确指定它关联的content_type和object_id字段。修正后的代码如下：

from django.db import models
from django.contrib.contenttypes.models import ContentType
from django.contrib.contenttypes.fields import GenericForeignKey

class Tag(models.Model):
    label = models.CharField(max_length=255)
    
class TaggedItem(models.Model):
    tag = models.ForeignKey(Tag, on_delete=models.CASCADE)  
    content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE)
    object_id = models.PositiveIntegerField()  
    # 重命名字段并指定关联的ForeignKey和ID字段
    content_object = GenericForeignKey('content_type', 'object_id')

额外提示 #

• GenericForeignKey本身不会在数据库中生成字段，它只是一个用于跨模型关联的代理字段，必须依赖已存在的content_type（ForeignKey类型）和object_id字段。
• 检查你的LikedItem模型，它大概率存在同样的字段覆盖问题，按照上述方式修正即可。

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