Django模板Date过滤器导致表单验证失败时值丢失问题

我之前也碰到过类似的问题，咱们先把核心原因说透：

当表单验证失败（也就是POST请求且form.is_valid()返回False）时，form.last_promotion_date.value存储的是用户输入的原始字符串（比如格式错误的日期，像2023/13/01），而Django内置的date:"Y/m/d"过滤器只能处理datetime.date类型的对象——对字符串来说，这个过滤器无法解析，最终就会输出空值。

而在GET请求场景下，form.last_promotion_date.value是从数据库读取的date对象，过滤器能正常识别并格式化，所以显示完全没问题。

下面给你几个可行的解决办法：

办法一：利用Django表单的自动渲染（最省心） #

直接使用表单字段的内置渲染代替手动写input标签，Django会自动处理验证失败时的回显和合法日期的格式化：

<form class="inner_box" method="POST" action="{% url 'core:first_view' %}" name="">
    {% csrf_token %}
    <table>
        <tr class="table_header">
            <th colspan="8" class="right">last_promotion_date</th>
            <td>{{ form.last_promotion_date }}</td>
        </tr>
    </table>
</form>

如果需要给input加class或者事件，你可以通过表单字段的widget参数在ModelForm里定义：

class PromotionModelForm(ModelForm):
    last_promotion_date = forms.DateField(
        input_formats=DATE_INPUT_FORMATS,
        widget=forms.TextInput(attrs={
            'class': 'date_picker',
            'onfocus': 'displayDatePicker(this.id);'
        })
    )
    class Meta:
        model = Professor
        fields = ['last_promotion_date']

办法二：模板内区分处理合法日期与无效输入 #

如果一定要手动写input标签，可以在模板里判断value是否能被date过滤器正常解析，不行就直接输出原始值：

<input type="text" name="last_promotion_date" onfocus="displayDatePicker(this.id);" class="date_picker" 
       value="{% if form.last_promotion_date.value %}
                   {% with formatted=form.last_promotion_date.value|date:"Y/m/d" %}
                       {{ formatted|default:form.last_promotion_date.value }}
                   {% endwith %}
               {% endif %}">

这里利用default过滤器，如果格式化后为空（也就是原始值是无效字符串），就返回用户输入的原始内容。

办法三：自定义模板过滤器（灵活性最高） #

如果需要在多个地方复用这个逻辑，可以写一个自定义模板过滤器，自动处理日期对象和无效字符串：

1. 在你的app目录下创建templatetags文件夹，里面新建custom_filters.py文件：

from django import template
from datetime import datetime

register = template.Library()

@register.filter
def format_date_or_raw(value, format_str="Y/m/d"):
    # 先处理字符串类型的输入
    if isinstance(value, str):
        # 尝试用定义的格式解析
        for fmt in ['%Y/%m/%d', '%Y-%m-%d']:
            try:
                date_obj = datetime.strptime(value, fmt).date()
                # 转换为目标格式
                return date_obj.strftime(format_str.replace("Y", "%Y").replace("m", "%m").replace("d", "%d"))
            except ValueError:
                continue
        # 解析失败返回原始字符串
        return value
    # 处理date对象
    elif hasattr(value, 'strftime'):
        return value.strftime(format_str.replace("Y", "%Y").replace("m", "%m").replace("d", "%d"))
    # 其他情况返回原值
    return value

2. 在模板顶部加载这个过滤器：

{% load custom_filters %}

3. 然后就可以用这个过滤器代替原生的date过滤器：

<input type="text" name="last_promotion_date" onfocus="displayDatePicker(this.id);" class="date_picker" 
       value="{{ form.last_promotion_date.value|format_date_or_raw:"Y/m/d" }}">

这样不管是合法的date对象还是无效的用户输入，都能正确显示了。

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