在Django项目开发过程中，表单提交时出现IntegrityError非空字段约束错误是非常典型的问题，这类错误会直接中断请求处理流程，导致数据无法正常入库。错误的核心原因是提交到数据库的数据，存在某个被设置为非空约束的字段没有接收到有效值，违反了数据库表结构的约束规则。
错误产生的常见原因
要解决问题首先需要明确错误来源，常见的触发场景有以下几种：
- 模型字段设置了
null=False且blank=False，但是表单没有对该字段做必填校验，导致提交了空值 - 视图层保存数据时，手动给模型实例赋值，遗漏了非空字段的赋值逻辑
- 数据库表已经存在历史数据，后续修改模型新增了非空字段，但是没有给旧数据设置默认值
- 表单中隐藏字段或者只读字段没有正确设置初始值，提交时为空
排查错误的步骤
第一步：查看完整错误堆栈
Django抛出的IntegrityError会包含具体的字段信息，比如错误提示会明确说明是哪个表的哪个字段违反了非空约束，首先记录下这个字段名称。
第二步：核对模型定义
找到对应模型的字段定义，确认该字段的非空约束配置，比如是否有null=False的设置，是否设置了default默认值。
第三步：检查表单提交数据
在视图层打印表单的cleaned_data或者直接打印request.POST数据，确认对应字段是否有值传入。
具体解决方案
方案一：调整模型字段配置
如果某个字段确实允许为空，可以修改模型字段的约束，将null设置为True，同时如果是字符串类型字段可以配合blank=True允许表单提交空值：
from django.db import models
class UserProfile(models.Model):
# 原来可能的定义是 name = models.CharField(max_length=50) 默认null=False
# 如果允许name为空，修改为如下配置
name = models.CharField(max_length=50, null=True, blank=True)
age = models.IntegerField()
修改模型后需要执行迁移命令让配置生效：
python manage.py makemigrations python manage.py migrate
方案二：完善表单验证规则
如果字段必须非空，需要在表单层添加必填校验，确保提交的数据符合要求。以ModelForm为例：
from django import forms
from .models import UserProfile
class UserProfileForm(forms.ModelForm):
class Meta:
model = UserProfile
fields = ["name", "age"]
# 显式指定字段为必填，默认ModelForm会根据模型字段的blank属性生成校验规则
widgets = {
"name": forms.TextInput(attrs={"required": True})
}
# 也可以自定义clean方法做额外校验
def clean_name(self):
name = self.cleaned_data.get("name")
if not name:
raise forms.ValidationError("姓名不能为空")
return name
方案三：修复视图层保存逻辑
如果在视图层手动创建模型实例保存，需要确保非空字段都被正确赋值：
from django.shortcuts import render, redirect
from .models import UserProfile
from .forms import UserProfileForm
def create_user(request):
if request.method == "POST":
form = UserProfileForm(request.POST)
if form.is_valid():
# 方式1：直接使用表单保存，会自动处理cleaned_data中的数据
form.save()
# 方式2：手动创建实例，必须确保所有非空字段都有值
# age是模型的非空字段，必须赋值，否则会触发IntegrityError
# user = UserProfile(name=request.POST.get("name"), age=request.POST.get("age"))
# user.save()
return redirect("user_list")
else:
form = UserProfileForm()
return render(request, "create_user.html", {"form": form})
方案四：处理历史数据和新增非空字段
如果是在已有数据的表上新增非空字段，需要先给旧数据设置默认值，再执行迁移：
from django.db import models
class UserProfile(models.Model):
name = models.CharField(max_length=50)
age = models.IntegerField()
# 新增的非空字段，设置默认值避免旧数据报错
email = models.EmailField(default="default@ippipp.com")
执行迁移时Django会提示选择处理方式，选择给旧数据设置默认值即可。
注意事项
需要注意null和blank的区别：null是数据库层面的约束，决定是否允许数据库中存储NULL值；blank是表单验证层面的约束，决定是否允许表单提交空值。字符串类型字段如果设置null=True通常也要配合blank=True，否则表单可以提交空值但是数据库不允许存储NULL，还是会报错。
另外如果错误是偶尔出现，需要检查是否有并发提交的场景，或者是否有部分请求没有经过表单验证直接调用了保存逻辑，确保所有入库的数据都经过完整的校验流程。
DjangoIntegrityError表单提交非空字段约束数据库约束修改时间：2026-07-12 01:39:25