本文介绍如何利用 Django 表单的 clean_ 方法实现手机号（10位纯数字）的后端校验，确保验证失败时其他表单字段数据不丢失，并配合模板正确显示错误提示。
本文介绍如何利用 django 表单的 `clean_
在 Django 中，用户提交注册表单时若仅因手机号格式错误（如非10位、含字母等）导致整个页面重载，而其他已填写字段（如姓名、邮箱）被清空，会严重影响用户体验。这并非 Django 的固有限制，而是未正确使用其内置表单验证机制所致。Django 的 Form 类天然支持“保留输入 + 精准报错”，关键在于将自定义校验逻辑封装在 clean_
✅ 正确做法：使用 clean_phone_number() 实现字段级校验
首先，在表单类中定义 phone_number 字段，并覆写对应的清理方法：
# forms.py
from django import forms
class RegistrationForm(forms.Form):
name = forms.CharField(max_length=100)
email = forms.EmailField()
phone_number = forms.CharField(
max_length=10,
widget=forms.TextInput(attrs={'placeholder': 'Enter 10-digit number'})
)
def clean_phone_number(self):
phone = self.cleaned_data.get('phone_number', '')
# 去除空格（可选，增强健壮性）
phone = phone.strip()
if len(phone) != 10 or not phone.isdigit():
raise forms.ValidationError("Phone number must be exactly 10 digits.")
return phone
⚠️ 注意：clean_
方法会在 is_valid() 调用时自动执行；它接收已初步清洗（如去除首尾空格）的值，返回处理后的值（或抛出 ValidationError）。Django 会自动将错误绑定到该字段，不会影响其他字段的数据状态。
? 视图层：保持表单实例复用
视图中需确保验证失败时仍传递同一 form 实例（含用户已提交的数据）：
# views.py
from django.shortcuts import render, redirect
from django.contrib import messages
from .forms import RegistrationForm
def register(request):
if request.method == 'POST':
form = RegistrationForm(request.POST) # 关键：传入 POST 数据
if form.is_valid():
# ✅ 所有字段校验通过，安全获取 cleaned_data
data = form.cleaned_data
# 保存用户、发送邮件等业务逻辑...
return redirect('registration_success')
# ❌ 验证失败：form 自动携带原始数据和错误信息，直接渲染
else:
form = RegistrationForm() # GET 请求，返回空表单
return render(request, 'registration_form.html', {'form': form})
? 模板层：显式渲染错误与字段
在模板中，必须分别渲染字段错误和字段本身，才能让 Django 自动填充已提交值并显示对应提示：
<!-- registration_form.html -->
Django 会自动为 form.phone_number 渲染 标签，并将 request.POST 中的值回填至 value 属性；同时，form.phone_number.errors 将输出
- ... 包裹的错误消息。
- 前端辅助校验：可在 HTML 中添加 pattern="\d{10}" 和 maxlength="10" 提升体验，但不可替代后端校验（前端可绕过）。
-
更严格的手机号验证：如需匹配国内手机号（1[3-9]\d{9}），可用正则替换 isdigit()：
import re if not re.fullmatch(r'1[3-9]\d{9}', phone): raise forms.ValidationError("Invalid Chinese mobile number format.") - 国际化考虑：若应用面向多国用户，建议改用 django-phonenumber-field 第三方库，支持 E.164 格式解析与验证。
? 补充建议与最佳实践
通过以上方式，你无需依赖 AJAX 或 JavaScript 即可实现健壮、易维护、符合 Django 设计哲学的表单验证流程——错误精准定位、数据全程保留、代码清晰可控。
