Django Formset使用非标准日期格式时验证失败问题排查

这个问题我之前也碰到过，核心原因是Django的DateField默认只解析YYYY-MM-DD格式的日期字符串，而你在模板里输入的March 20 2018不在默认的解析格式列表里，导致视图场景下表单验证失败；但shell中你大概率是直接传入Python date对象或者符合默认格式的字符串，所以不会触发错误。另外，验证失败的字段确实不会出现在cleaned_data里——这是Django表单的默认行为，只有通过验证的字段才会被放入cleaned_data。

下面是具体的解决步骤：

1. 为DateField添加自定义输入格式 #

你需要在表单类（或ModelForm）中，给due_date字段指定input_formats参数，把March 20 2018对应的格式%B %d %Y加入进去。这样Django就会按顺序尝试解析这些格式的字符串：

from django import forms

class YourForm(forms.Form):
    # 定义允许的日期输入格式，按优先级排序
    due_date = forms.DateField(
        input_formats=['%Y-%m-%d', '%B %d %Y'],
        # 可自定义widget，比如添加提示文本
        widget=forms.DateInput(attrs={'type': 'text', 'placeholder': 'YYYY-MM-DD or March 20 2018'})
    )

如果是使用ModelFormset，只需要在对应的ModelForm中重写这个字段即可，逻辑完全一致。

2. 调试验证错误的小技巧 #

如果不确定具体的错误原因，可以在视图中打印表单集的错误信息，直观查看验证失败的细节：

if request.method == 'POST':
    formset = YourFormSet(request.POST)
    if not formset.is_valid():
        # 打印所有表单的错误，方便排查
        print(formset.errors)
        # 也可以单独查看某一个表单的错误
        # print(formset.forms[0].errors)

你应该会看到类似{'due_date': ['Enter a valid date.']}的错误提示，这就能确认是日期格式不匹配的问题。

3. 补充说明：为什么shell中没问题？ #

在shell环境下，你可能是这样测试的：

from your_app.forms import YourForm
form = YourForm({'due_date': date(2018, 3, 20)})
# 或者直接传入符合默认格式的字符串
form = YourForm({'due_date': '2018-03-20'})
form.is_valid()  # 返回True

这种场景下要么直接传了date对象（Django会直接接受），要么字符串符合默认格式，所以验证通过。但浏览器提交的是原始的March 20 2018字符串，Django用默认格式解析失败，就会导致验证不通过。

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