本文详解 Django 表单 is_valid() 恒为 False 的核心原因——尤其是 clean() 方法未返回 cleaned_data 导致字段“消失”，并提供完整可运行的修复方案，涵盖表单定义、视图逻辑、模板渲染及安全最佳实践。
本文详解 django 表单 `is_valid()` 恒为 `false` 的核心原因——尤其是 `clean()` 方法未返回 `cleaned_data` 导致字段“消失”，并提供完整可运行的修复方案，涵盖表单定义、视图逻辑、模板渲染及安全最佳实践。
在 Django 开发中，表单验证失败却找不到明确错误提示（如日志显示 telefone 和 foto 字段“required”，但前端已填写）是一个高频陷阱。根本原因往往不是数据未提交，而是自定义 clean() 方法破坏了 Django 表单的数据流机制。
? 关键问题：clean() 方法必须显式返回 cleaned_data
Django 表单的 clean() 方法承担双重职责：执行自定义验证 + 返回清洗后的数据字典。若遗漏 return cleaned_data，Django 会将 cleaned_data 视为 None，导致所有字段（包括非空字段）被判定为“缺失”，从而触发 required=True 的默认校验失败。
你的 forms.py 中存在此致命疏漏：
def clean(self):
cleaned_data = super().clean()
# ... 验证逻辑（如电话格式、邮箱校验等）
# ❌ 缺少这一行！
# return cleaned_data ← 必须添加✅ 正确写法如下（同时修复其他关键问题）：
Django Unfold
下载
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
# forms.py
from django import forms
from django.core.exceptions import ValidationError
from django.core.validators import validate_email
import re
class cadastroForm(forms.Form):
nome = forms.CharField(label="Nome completo", max_length=100, required=True)
telefone = forms.CharField(label="Telefone", max_length=20, required=True) # 优化长度
email = forms.EmailField(label="Email", required=True)
iesb = forms.ChoiceField(
label="Frequenta o IESB",
choices=[('Yes', 'Sim'), ('No', 'Não')],
widget=forms.RadioSelect,
required=True
)
mat = forms.IntegerField(label="Matrícula", required=False) # 注意：radio控制是否必填，此处设False
foto = forms.ImageField(label="Foto", required=False) # 文件字段需单独处理，非必需时设False
def clean(self):
cleaned_data = super().clean()
nome = cleaned_data.get("nome")
telefone = cleaned_data.get("telefone")
email = cleaned_data.get("email")
iesb = cleaned_data.get("iesb")
mat = cleaned_data.get("mat")
# 名字首字母大写标准化（注意：.title() 是方法，非属性）
if nome and isinstance(nome, str):
cleaned_data["nome"] = nome.title()
# 电话号码纯数字校验
if telefone and re.search(r'[a-zA-Z]', telefone):
raise ValidationError("O número de telefone não pode possuir letras")
# 邮箱验证（Django EmailField 已内置，此处为双重保险）
try:
validate_email(email)
except ValidationError:
raise ValidationError("Endereço de e-mail inválido")
# 条件必填：仅当选择 'Yes' 时，mat 必须存在
if iesb == "Yes" and (mat is None or mat <= 0):
raise ValidationError("Se frequenta o IESB, deve informar uma matrícula válida")
# ✅ 关键修复：必须返回清洗后的数据
return cleaned_data?️ 视图层：确保正确渲染与重定向
原视图缺少 render() 调用，导致 GET 请求无响应；且文件上传需启用 request.FILES：
# views.py
from django.shortcuts import render, HttpResponseRedirect
from django.urls import reverse
from .forms import cadastroForm
from .utils import insert_data # 假设你的数据插入函数
def get_form(request):
if request.method == 'POST':
form = cadastroForm(request.POST, request.FILES) # ✅ 添加 request.FILES 处理文件上传
if form.is_valid():
# 获取清洗后数据（安全！）
cd = form.cleaned_data
insert_data(
nome=cd['nome'],
mat=cd.get('mat'), # 可能为None
telefone=cd['telefone'],
email=cd['email']
)
# 若需保存图片，需额外处理 cd['foto']
return HttpResponseRedirect(reverse('all-borrowed'))
else:
form = cadastroForm()
# ✅ 必须返回渲染结果（处理GET和POST失败）
return render(request, 'cadastro.html', {'form': form})? 模板层：使用 Django 表单渲染，告别手写 HTML
手动编写 <input> 易出错（如 name 不匹配、CSRF token 遗漏、错误信息不显示）。推荐使用 {{ form }} 或更精细的 {{ form.field }}：
<!-- cadastro.html -->
{% block page_content %}
<h1 style="text-align: center; margin-top: 10%; margin-bottom: 5%; font-size: 64px;">Cadastro</h1>
<form method="POST" enctype="multipart/form-data"> <!-- ✅ 添加 enctype -->
{% csrf_token %}
{{ form.as_p }} <!-- 自动渲染所有字段+错误信息 -->
<input type="submit" value="Enviar" style="margin: auto; display: block;">
</form>
<script>
// 注意：Django 渲染后 radio 的 name 是 'iesb'，ID 需对应
document.addEventListener('DOMContentLoaded', function() {
const simRadio = document.getElementById('id_iesb_0');
const naoRadio = document.getElementById('id_iesb_1');
const matInput = document.getElementById('id_mat');
const updateMatDisabled = () => {
matInput.disabled = naoRadio.checked;
};
simRadio.addEventListener('change', updateMatDisabled);
naoRadio.addEventListener('change', updateMatDisabled);
updateMatDisabled(); // 初始化状态
});
</script>
{% endblock %}⚠️ 重要注意事项
- 文件上传必备 enctype="multipart/form-data"：缺失则 request.FILES 为空。
- RadioSelect 需配合 ChoiceField：你原代码中 b_iesb = forms.RadioSelect(...) 是错误用法（RadioSelect 是 widget，非字段）。
- clean() 中修改 cleaned_data 后必须 return：这是最常被忽略的硬性规则。
- 前端 JS 控制 disabled 状态，不影响后端校验：后端仍需按业务逻辑校验（如 iesb=="Yes" 时 mat 是否有效）。
- 敏感操作建议使用 get_absolute_url() 或命名 URL：避免硬编码 action="../../views.py"（易出错且不安全）。
遵循以上修正，你的表单将准确响应用户输入，错误信息清晰可见，数据流完整可控——这才是 Django 表单开发的最佳实践。
