Django模型设blank=True,null=True仍触发NOT NULL约束错误

排查方向和解决办法 #

1. 先确认模型字段配置+数据库迁移 #

别光看models.py里写了blank=True, null=True，得注意：

• 字符串类型字段（CharField、TextField）必须同时加null=True，不然数据库层面还是NOT NULL约束（Django默认字符串字段存空字符串，但数据库不认这个，会触发错误）。
• 修改模型后必须跑迁移，不然数据库的约束没更新，等于白改。执行以下命令：

  python manage.py makemigrations
  python manage.py migrate
  

2. 检查ModelForm有没有强制设required属性 #

如果forms.py里手动给字段加了required=True，哪怕模型设了blank，表单也会强制要求填。比如别写这种代码：

# 错误示例，请勿这么写！
description = forms.CharField(required=True, widget=forms.Textarea)

让ModelForm自动继承模型的配置就行，Meta类里指定fields即可，别手动覆盖字段属性。

3. 视图里别手动给字段赋值空字符串 #

如果在save前手动把空字段设成''（空字符串），而模型只设了null=True没设default=''，数据库会把空字符串当成非空值，照样触发NOT NULL错误。比如别做这种操作：

# 错误示例，请勿这么写！
work = form.save(commit=False)
work.description = request.POST.get('description', '')
work.save()

直接form.save()就行，Django会自动把空值转成NULL（当模型设了null=True时）。

4. 后台也报错？那肯定是模型或数据库的问题 #

管理后台直接基于模型操作，所以如果后台也报错，说明不是表单的锅，重点查：

• 模型字段是不是真的同时设了blank=True, null=True
• 迁移是不是真的执行了，有没有生成迁移文件并应用到数据库

对照代码的正确示例 #

models.py（正确写法） #

from django.db import models

class Work(models.Model):
    title = models.CharField(max_length=200)  # 必填字段正常配置
    description = models.TextField(blank=True, null=True)  # 可选字段必须同时加两个参数
    author = models.CharField(max_length=100, blank=True, null=True)
    publish_date = models.DateField(blank=True, null=True)  # 日期字段同理

forms.py（正确写法） #

from django.forms import ModelForm
from .models import Work

class WorkForm(ModelForm):
    class Meta:
        model = Work
        fields = ['title', 'description', 'author', 'publish_date']
        # 无需手动修改字段，自动继承模型的可选配置

views.py（正确写法） #

from django.shortcuts import render, redirect
from .forms import WorkForm

def create_work(request):
    if request.method == 'POST':
        form = WorkForm(request.POST)
        if form.is_valid():
            form.save()  # 直接保存，不要手动干预空字段赋值
            return redirect('work_list')
    else:
        form = WorkForm()
    return render(request, 'create_work.html', {'form': form})

内容的提问来源于stack exchange，提问作者Dhruva Gowda Storz