Django ModelForm表单无法提交 附全链路代码求故障排查

你的表单无法提交是多个代码错误共同导致的，按影响优先级排序：

• 禁用表单字段未提交，触发必填校验失败
  你在forms.py里给department字段加了'disabled': 'true'属性，浏览器默认不会提交被disabled的表单项。但Contratos模型中department字段没有设置blank=True，属于必填项，表单校验时因为拿不到department的值直接判定为无效，而你的视图代码在校验失败时没有返回错误提示，直接重定向到列表页，表现出来就是提交后没有保存成功。
• 模型字段默认值写法错误
  模型中department字段的default参数写的是全大写NONE，Python中空值为大写开头的None，全大写NONE属于未定义变量，本身就会导致代码运行报错。
• 文件上传逻辑缺失
  模型包含attached_file文件字段，但你的form标签没有加enctype="multipart/form-data"属性，视图实例化表单时也没有传入request.FILES参数，只要用户上传附件就会提交失败，即使不上传附件，也会因为表单构造不完整触发校验异常。
• 视图无错误反馈逻辑
  你现在的POST处理逻辑里，只要form.is_valid()返回False就直接重定向，完全不渲染表单错误，导致你看不到具体的校验失败原因，没法定位问题。
• 非阻断性代码错误：模型里重复定义了两次is_upperclass方法，后定义的会覆盖前序逻辑，虽然不直接影响表单提交，但属于逻辑bug。

按以下步骤逐一修改代码：

1. 修复模型层错误
   修改Contratos模型相关字段，修正None拼写，给允许为空的字段加上blank=True参数：

# models.py 对应字段修改为
class Contratos(models.Model):
    # ... 其他字段不变
    currency=models.CharField(
        max_length=2,
        choices=CURR_CHOICES,
        default=None,
        blank=True
        )
    # 删掉第一个重复定义的is_upperclass方法
    type=models.CharField(
        max_length=2,
        choices=TIPO_CHOICES,
        default=None,
        blank=True
        )
    department=models.CharField(
        max_length=2,
        choices=depc_CHOICES,
        default=None,
        blank=True
        )
    # ... 其他字段不变

注意：模型修改后需要执行python manage.py makemigrations和python manage.py migrate同步数据库结构。

2. 修复表单disabled字段问题
   如果需要保留department字段的禁用状态，不要直接用html的disabled属性，改用readonly属性，或者在表单初始化时给字段赋固定初始值；如果是需要通过JS动态赋值的场景，也可以保留disabled，但要在视图中手动给字段赋值后再做校验。如果不需要禁用，直接删掉widget里的'disabled': 'true'配置即可。

3. 修复文件上传逻辑
   首先修改模板里的form标签，加上文件上传必须的enctype属性：

<form action="" method="post" autocomplete="off" class="row g-3" enctype="multipart/form-data">

然后修改视图里的表单实例化代码，传入request.FILES：

form = ContractsForm(request.POST, request.FILES)

4. 补充视图的错误返回逻辑，方便调试
   修改POST分支的代码，校验失败时把带着错误信息的表单返回给模板，就能直接在页面看到具体报错：

# views.py 中contract_form修改为
def contract_form(request):
    if request.method == "GET":
        form = ContractsForm()
        return render(request,"contracts_form.html", {'form':form})
    else:
        form = ContractsForm(request.POST, request.FILES)
        if form.is_valid():
            form.save()
            return redirect('/contracts')
        # 校验失败时返回带错误的表单
        return render(request,"contracts_form.html", {'form':form})

改完上述问题如果还是提交失败，可以直接在视图里打印form.errors看具体的校验错误字段，能快速定位剩余问题：

else:
    form = ContractsForm(request.POST, request.FILES)
    print(form.errors) # 控制台会输出具体的字段错误信息
    if form.is_valid():
        form.save()
        return redirect('/contracts')
    return render(request,"contracts_form.html", {'form':form})

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