如何解决Django自定义表单验证器无法正常生效的问题

一、先排查语法与字段配置错误 #

• forms.py中NumberInput的attrs属性里name字段的单引号未闭合：原代码写的是'name': 'main,，缺了结尾的单引号，会直接触发语法错误
• 你手动修改了widget的name属性为main，和表单字段名main_form不一致，会导致后续取值、验证的匹配错误，建议直接删除自定义name配置，让Django自动生成和字段名一致的name值
• 字段设置了required=False，如果前端没有传对应参数、或者传了空值，Django会直接跳过该字段的所有验证逻辑，只有传了非空值才会执行你的自定义验证器

二、再排查视图层的验证触发逻辑错误 #

Django表单不会自动触发验证，必须手动传入请求数据并调用验证方法才会执行验证器，你的视图代码存在多处核心逻辑错误：

• 实例化表单时没有传入请求参数：空实例form = MyForm()永远不会触发任何验证，必须把request.GET作为参数传入
• 没有调用form.is_valid()方法：只有调用该方法才会执行所有字段的验证逻辑，包括你的自定义验证器
• request.GET.get(main_form)写法错误：main_form没有加引号属于未定义变量，应该传字符串参数，对应字段的name值
• 操作不存在的表单字段：form.fields['main_form_result']里的字段名不存在，你的表单类里只有main_form字段
• 上下文context的键错误：原代码写的是{form: form}，键应该是字符串'form'，否则模板无法正常读取表单对象

三、验证器逻辑优化 #

如果需要在空值场景下也触发验证，可以修改自定义验证器兼容空值逻辑：

def use_one(value):
    # 如果你要求哪怕空值也要报错，就去掉下面的判断，或者将字段required改为True
    if value is None:
        return
    if value != 1:
        raise forms.ValidationError("Value is not 1!")

四、修正后的完整代码示例 #

forms.py #

from django import forms
from django.core.exceptions import ValidationError
from .models import Vote
from django.core.validators import MaxValueValidator, MinValueValidator


def use_one(value):
    if value != 1:
        raise forms.ValidationError("Value is not 1!")

class MyForm(forms.Form):
     main_form = forms.IntegerField(
            validators = [use_one], 
            label= 'Main', 
            required = True,
            widget = forms.NumberInput(
                attrs={
                    'id': 'mainInput',
                    'href': '#',
                    'value': '',
                    'class': "form-control"
                }
            )
     )

views.py #

# 传入请求数据实例化表单
form = MyForm(request.GET)
main_result = None
# 触发验证
if form.is_valid():
    # 验证通过后取清洗后的合规数据
    main_result = form.cleaned_data['main_form']

context = {'form': form}

额外注意 #

模板渲染时要添加错误提示的渲染代码，才能看到验证失败的提示：

{{ form.main_form.errors }}
{{ form.main_form }}

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