Django Admin中Customer Model出现'-'条目，无法操作且报错求助

问题描述 #

学习Django时，发现Customer模型的admin列表中有一个显示为-的条目，尝试删除或打开该条目时触发TypeError：

TypeError at /admin/accounts/customer/3/change/
str returned non-string (type NoneType)

相关信息：

• 请求方法：GET
• 请求URL：http://127.0.0.1:8000/admin/accounts/customer/3/change/
• Django版本：4.1.3
• Python版本：3.11.0

测试其他正常命名的用户条目时操作正常，仅该-条目无法操作。对应的models.py代码如下：

from django.db import models
from django.contrib.auth.models import User

# Create your models here.
class Customer(models.Model):
    user = models.OneToOneField(User, null=True, blank=True, on_delete=models.CASCADE)
    name = models.CharField(max_length=200, null=True)
    phone = models.CharField(max_length=200, null=True)
    email = models.CharField(max_length=200, null=True)
    profile_pic = models.ImageField(default="profile1.png", null=True, blank=True)
    date_created = models.DateTimeField(auto_now_add=True, null=True)

    def __str__(self):
        return self.name


class Tag(models.Model):
    name = models.CharField(max_length=200, null=True)

    def __str__(self):
        return self.name


class Product(models.Model):
    CATEGORY = (
        ("Indoor", "Indoor"),
        ("Outdoor", "Outdoor"),
    )

    name = models.CharField(max_length=200, null=True)
    price = models.FloatField(null=True)
    category = models.CharField(max_length=200, null=True, choices=CATEGORY)
    description = models.CharField(max_length=200, null=True, blank=True)
    date_created = models.DateTimeField(auto_now_add=True, null=True)
    tags = models.ManyToManyField(Tag)

    def __str__(self):
        return self.name


class Order(models.Model):
    STATUS = (
        ("Pending", "Pending"),
        ("Out for delivery", "Out for delivery"),
        ("Delivered", "Delivered"),
    )

    customer = models.ForeignKey(Customer, null=True, on_delete=models.SET_NULL)
    product = models.ForeignKey(Product, null=True, on_delete=models.SET_NULL)
    date_created = models.DateTimeField(auto_now_add=True, null=True)
    status = models.CharField(max_length=200, null=True, choices=STATUS)
    note = models.CharField(max_length=200, null=True)

    def __str__(self):
        return self.product.name

原因分析 #

1. '-'条目的来源：Customer模型的__str__方法直接返回self.name，但该条目的name字段值为null（数据库中为空）。Django Admin在渲染模型实例时，若__str__返回None，会默认显示-作为占位符。
2. 报错原因：Python要求__str__方法必须返回字符串类型，当name为None时，直接返回self.name就返回了NoneType，违反类型要求触发TypeError。

解决方法 #

1. 修复Customer模型的__str__方法 #

修改__str__方法，确保无论name是否为空都返回字符串：

def __str__(self):
    # 优先显示name，为空则用ID标识，也可关联user的用户名
    return self.name or f"Customer #{self.id}"
    # 若需要关联User的用户名，可改为：
    # return self.name or (self.user.username if self.user else f"Customer #{self.id}")

2. 处理异常条目 #

方法一：通过Django Shell删除

在项目根目录打开终端，执行：

python manage.py shell

进入shell后执行：

from accounts.models import Customer
# 定位到ID为3的异常条目（对应错误URL中的ID）
customer = Customer.objects.get(id=3)
customer.delete()

方法二：修改__str__后通过Admin操作

修改__str__方法后，无需迁移（因为是模型方法修改），直接重启Django服务器。此时Admin列表中该条目会显示为Customer #3，可正常打开或删除。

3. 避免后续出现类似问题 #

可以修改name字段的定义，强制其不为空：

# 去掉null=True，设置blank=True允许表单提交为空，但保存时确保有默认值
name = models.CharField(max_length=200, blank=True, default="")

或者在创建Customer实例时，确保name字段始终被赋值。

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