Django 5.0模型字段已设默认值仍触发NULL错误求助

问题场景 #

基于Django 5.0定义了如下Vendor模型类，使用MySQL数据库，已确认数据库DDL中web_url列的默认值为''：

class Vendor(models.Model):
    """
    ORM representing vendors

    Relationships:
    A vendor may have many documents
    """

    id = models.AutoField(
        primary_key=True,
    )
    name = models.CharField(
        max_length=255,
        blank=True,
        db_default='',
        default='',
    )
    logo_uri = models.CharField(
        max_length=255,
        blank=True,
        db_default='',
        default='',
    )
    web_url = models.CharField(
        max_length=255,
        blank=True,
        db_default='',
        default=None,
    )
    created_on = models.DateTimeField(
        auto_now_add=True,
        null=False,
    )

    def __str__(self) -> str:
        return f"{self.name}"
    
    class Meta:
        ordering =  ["created_on"]
        verbose_name = "vendor"
        verbose_name_plural = "vendors"

直接通过MySQL的SQL语句插入数据时，默认值可正常生效：

INSERT INTO `core_vendor`
(`name`,
`created_on`)
VALUES
('TES',
  NOW()
);

但通过Django代码编程插入数据时：

vendor = Vendor()
vendor.name='TES2'
vendor.web_url=None
vendor.save()

收到错误：

django.db.utils.IntegrityError: (1048, "Column 'web_url' cannot be null")

明明web_url字段在Django和数据库层面都设置了默认值，问题出在哪里？

问题原因 #

核心问题是你主动给web_url赋值为None，这和让字段使用默认值是完全不同的两种操作：

• 当你不设置web_url字段时，Django才会触发模型定义的default（或数据库的db_default）逻辑，自动填充默认值；
• 但你显式设置vendor.web_url=None后，Django会将None作为明确的值提交给数据库，而你的数据库列并未配置允许NULL（模型里没加null=True），因此触发了非空约束错误。

另外，你的web_url模型字段设置了default=None，这本身就和db_default=''矛盾——Django层面的默认值是None，但数据库不允许NULL，这也是潜在的隐患。

解决方案 #

方案1：移除显式的None赋值 #

不要主动设置web_url为None，让Django自动应用默认值：

vendor = Vendor()
vendor.name='TES2'
# 移除 vendor.web_url=None 这一行
vendor.save()

方案2：修正模型字段配置 #

如果业务场景中确实需要处理None值，可以修改模型字段，添加null=True（同时建议把default改成和db_default一致的空字符串，避免逻辑矛盾）：

web_url = models.CharField(
    max_length=255,
    blank=True,
    null=True,  # 允许数据库列存储NULL
    db_default='',
    default='',  # 统一Django层面的默认值为''
)

修改后需要执行迁移命令更新数据库结构：

python manage.py makemigrations
python manage.py migrate

方案3：代码层面处理None值 #

在赋值前将None转换为空字符串，确保提交给数据库的是合法值：

vendor = Vendor()
vendor.name='TES2'
# 假设some_value是可能为None的变量
vendor.web_url = '' if some_value is None else some_value
vendor.save()

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