Django表单验证失败后无法保留输入值，按官方指南操作仍无效

我来帮你搞定这个头疼的问题！根据你描述的情况，虽然照着官方指南操作，但还是没保留输入值，大概率是视图或模板的细节没处理对，下面给你一步步排查和解决：

首先检查视图核心逻辑：别重新创建空表单！ #

这是最常见的坑——很多人会在验证失败时不小心新建一个空表单，导致之前的输入数据全丢了。正确的视图流程应该严格遵循官方指南的要求：

错误示例（别这么写！） #

def test(request):
    if request.method == 'POST':
        form = TestForm(request.POST)
        if not form.is_valid():
            # 这里错了！新建空表单会丢失所有提交的数据
            form = TestForm()
            return render(request, 'test.html', {'form': form})
        # 验证通过的逻辑...
    else:
        form = TestForm()
    return render(request, 'test.html', {'form': form})

正确示例（完全符合官方指南） #

from django.shortcuts import render
from .forms import TestForm

def test(request):
    if request.method == 'POST':
        # 把POST数据绑定到表单实例
        form = TestForm(request.POST)
        if form.is_valid():
            # 处理验证通过的操作，比如保存数据
            form.save()
            # 建议验证成功后重定向，避免重复提交
            # return redirect('success_page')
        # 验证失败？直接返回这个已经绑定了数据的form就行！
        return render(request, 'test.html', {'form': form})
    else:
        # GET请求时返回未绑定的空表单
        form = TestForm()
        return render(request, 'test.html', {'form': form})

划重点：验证失败时，绝对不要重新初始化表单，直接把那个已经接收了POST数据的form实例传给模板，它已经是绑定状态，会自动带着用户之前的输入值。

然后检查模板渲染方式：别手动写input踩坑！ #

如果视图没问题，那大概率是模板里的表单渲染出错了：

推荐用法：用Django表单的内置渲染方法 #

直接用{{ form.as_p }}、{{ form.as_table }}或{{ form.as_ul }}，Django会自动帮你渲染带值的input，还会处理错误提示：

<form method="post">
    {% csrf_token %}
    <!-- 自动渲染所有字段，验证失败时保留输入值 -->
    {{ form.as_p }}
    <button type="submit">提交</button>
</form>

手动渲染字段的正确姿势 #

如果一定要自己写HTML结构，必须确保两点：

1. name属性和表单类里的字段名完全一致
2. value属性设置为{{ form.字段名.value|default_if_none:'' }}（处理空值情况）

示例：

<form method="post">
    {% csrf_token %}
    <div>
        <label for="{{ form.username.id_for_label }}">用户名:</label>
        <input 
            type="text" 
            id="{{ form.username.id_for_label }}" 
            name="{{ form.username.name }}" 
            value="{{ form.username.value|default_if_none:'' }}"
        >
        <!-- 顺便显示错误信息 -->
        {% if form.username.errors %}
            <span class="text-red">{{ form.username.errors.0 }}</span>
        {% endif %}
    </div>
    <button type="submit">提交</button>
</form>

最后再排查两个细节 #

• 检查表单类的字段定义：确保字段名和模板里用的完全一致，比如表单里是username，模板里不能写成user_name
• 确认没有在模板里硬编码value为空字符串，比如<input value="">会覆盖表单绑定的值

按照上面的步骤排查，应该就能解决验证失败后不保留输入值的问题啦！

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