升级Django至5.0.3后ContentType显示格式变更致功能异常的解决咨询

Django 5.0.3 对 ContentType 模型的 __str__ 方法做了向后不兼容修改：原版本仅返回 model 字段值，新版本改为返回 app_label: model 格式，这导致依赖 ContentType 字符串表示的自定义功能（如表单选项显示、模型 __str__ 输出）出现异常。

1. 修复表单下拉选项显示 #

针对 ProjectTaskForm 中的 experience 字段，自定义选项文本生成逻辑，恢复旧版仅显示 model 的格式：

class ProjectTaskForm(forms.ModelForm):
    experience = forms.ModelChoiceField(
        required=False,
        widget=forms.Select(attrs={'class': 'experience-selection'}),
        queryset=ContentType.objects.filter(app_label__in=app_label, model__in=models_)
    )

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 自定义选项显示文本
        self.fields['experience'].label_from_instance = lambda obj: obj.model

    class Meta:
        model = ProjectTask
        fields = '__all__'

2. 修复 ProjectTask 的字符串输出 #

修改 ProjectTask 的 __str__ 方法，直接调用 experience.model 而非依赖 ContentType 的默认字符串转换：

class ProjectTask(models.Model):
    # 原有字段定义保持不变
    project = models.ForeignKey('mentortogether.Project', on_delete=models.CASCADE, related_name='tasks')
    experience = models.ForeignKey(ContentType, on_delete=models.CASCADE)
    item_id = models.PositiveIntegerField()
    item = GenericForeignKey('experience', 'item_id')
    role = models.CharField(choices=MtUserRoles.CHOICES, max_length=10, default=MtUserRoles.BOTH)

    class Meta:
        unique_together = ("project", "experience", "item_id")

    objects = ProjectTaskManager()

    def __str__(self):
        # 替换原有的 self.experience 为 self.experience.model
        return "{}-{}".format(self.experience.model, self.item)

3. 全局修复（猴子补丁） #

如果项目中大量直接使用 str(content_type)，不想逐个修改，可以通过猴子补丁全局替换 ContentType 的 __str__ 方法，恢复旧版行为：
在项目主应用的 apps.py 中添加：

from django.apps import AppConfig
from django.contrib.contenttypes.models import ContentType

class YourAppConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'your_app_name'  # 替换为你的应用名称

    def ready(self):
        # 覆盖ContentType的__str__方法
        def content_type_str(self):
            return self.model
        ContentType.__str__ = content_type_str

• 优先采用局部修复（方案1、2），全局猴子补丁虽然便捷，但可能与后续Django版本更新产生冲突，需谨慎使用。
• 全面检查项目中所有使用 str(content_type) 的场景（如日志输出、模板渲染、业务逻辑判断），确保所有依赖点都已适配或修改为直接访问 content_type.model 字段。

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