Django将大小写不同的同字段值识别为不同实体问题排查求助

你的代码存在两个直接引发问题的错误：

• 字段定义语法错误：name = models.CharField(max_length=30,validators=[alphanumeric]).title() 是完全无效的写法。模型类属性必须接收字段类的实例，在字段定义末尾直接调用.title()会在项目启动加载模型时就执行，根本不会在数据保存环节触发，完全起不到统一字符串格式的效果。
• 数据逻辑缺失：直接用CharField存储artist、genre、language这类可复用的分类实体，数据库默认对字符串做大小写敏感的精确匹配，且你没有添加存库前的格式统一、重复值校验逻辑，自然会把仅存在大小写差异的同名词条识别为不同实体。

优先选第一种符合数据库设计范式的方案，长期维护成本最低。

方案1（推荐）：抽离独立实体模型，增加大小写不敏感的唯一约束 #

把artist、genre、language从Song模型的普通字段拆成独立模型，自定义大小写不敏感的字段类，存库前自动统一格式、拦截重复值：

from django.db import models
from django.core.validators import RegexValidator
from django.core.exceptions import ValidationError
from django.utils.text import slugify

alphanumeric = RegexValidator(r'^[0-9a-zA-Z\s]*$', '仅允许输入字母、数字、空格')

# 自定义大小写不敏感的统一格式字段
class CaseInsensitiveNameField(models.CharField):
    def get_prep_value(self, value):
        # 存库前自动去除首尾空格、转为首字母大写的统一格式
        return str(value).strip().title() if value else value

    def validate(self, value, model_instance):
        # 校验时用大小写不敏感规则匹配重复值
        formatted_val = self.get_prep_value(value)
        duplicate_exists = model_instance.__class__.objects.filter(
            **{f"{self.name}__iexact": formatted_val}
        ).exclude(pk=model_instance.pk).exists()
        if duplicate_exists:
            raise ValidationError(f"{self.verbose_name}已存在，请勿添加仅大小写不同的重复条目")
        super().validate(value, model_instance)

class Artist(models.Model):
    name = CaseInsensitiveNameField(max_length=30, validators=[alphanumeric], unique=True)
    slug = models.SlugField(default="", blank=True, db_index=True)

    def __str__(self):
        return self.name

class Genre(models.Model):
    name = CaseInsensitiveNameField(max_length=30, validators=[alphanumeric], unique=True)
    def __str__(self):
        return self.name

class Language(models.Model):
    name = CaseInsensitiveNameField(max_length=30, validators=[alphanumeric], unique=True)
    def __str__(self):
        return self.name

class Song(models.Model):
    name = models.CharField(max_length=30, validators=[alphanumeric])
    slug = models.SlugField(default="", blank=True, db_index=True)
    artist = models.ForeignKey(Artist, on_delete=models.CASCADE, related_name="songs")
    genre = models.ForeignKey(Genre, on_delete=models.CASCADE, related_name="songs")
    language = models.ForeignKey(Language, on_delete=models.CASCADE, related_name="songs")
    image = models.ImageField(null=True, blank=True)

    def save(self, *args, **kwargs):
        # 统一歌曲名称格式、自动生成slug
        self.name = self.name.strip().title()
        if not self.slug:
            self.slug = slugify(self.name)
        super().save(*args, **kwargs)

修改完成后依次执行python manage.py makemigrations、python manage.py migrate应用表结构变更即可。后续在admin panel录入数据时，不管输入什么大小写的同名artist/genre/language，都会自动转成统一格式，重复条目会直接触发校验提示，不会生成重复实体。

方案2（临时兼容，不推荐长期用） #

如果你暂时不想调整表结构拆分外键，可以直接在Song模型内增加格式统一和重复值处理逻辑，不用改原有表结构：

from django.db import models
from django.core.validators import RegexValidator
from django.utils.text import slugify

alphanumeric = RegexValidator(r'^[0-9a-zA-Z\s]*$', '仅允许输入字母、数字、空格')

class Song(models.Model):
    name = models.CharField(max_length=30,validators=[alphanumeric])
    slug=models.SlugField(default="",blank=True,null=False,db_index=True)
    artist = models.CharField(max_length=30,validators=[alphanumeric])
    genre = models.CharField(max_length=30,validators=[alphanumeric])
    language = models.CharField(max_length=30,validators=[alphanumeric])
    image = models.ImageField(null=True,blank=True)

    def clean(self):
        # Admin校验阶段自动匹配已存在的同名词条，直接复用标准化后的值
        same_artist = Song.objects.filter(artist__iexact=self.artist.strip().title()).exclude(pk=self.pk).first()
        if same_artist:
            self.artist = same_artist.artist
        same_genre = Song.objects.filter(genre__iexact=self.genre.strip().title()).exclude(pk=self.pk).first()
        if same_genre:
            self.genre = same_genre.genre
        same_lang = Song.objects.filter(language__iexact=self.language.strip().title()).exclude(pk=self.pk).first()
        if same_lang:
            self.language = same_lang.language

    def save(self, *args, **kwargs):
        # 存库前统一所有字符串字段的格式
        self.name = self.name.strip().title()
        self.artist = self.artist.strip().title()
        self.genre = self.genre.strip().title()
        self.language = self.language.strip().title()
        if not self.slug:
            self.slug = slugify(self.name)
        super().save(*args, **kwargs)

注意：必须删掉原有name字段定义末尾无效的.title()调用，否则模型加载会报错。

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