Django分页表单返回上一页时无法显示已填值的问题排查

核心问题分析 #

你遇到的问题根源有两个：

1. 错误设置了form.is_bound = True：未绑定的表单（GET请求时创建的空表单）被强行标记为绑定状态后，Django会按照绑定表单的逻辑渲染——绑定表单优先使用提交的数据（此处无有效提交数据），从而忽略initial值，导致页面显示空表单。
2. 错误修改字段级别的initial：直接修改form.fields[field_name].initial是修改表单类的默认初始值，而非当前表单实例的初始值，这种方式无法被模板渲染逻辑正确识别。

修复步骤 #

1. 修正GET方法中的表单初始化逻辑 #

将原来的表单绑定代码替换为正确的实例级初始值设置，同时移除错误的is_bound赋值：

def get(self, request):
    # 先从session获取已提交的数据
    form_data = request.session.get('form_data', {})
    
    # 实例化表单时直接传入对应字段的初始值
    forms = [
        PatientsForm(initial={k: v for k, v in form_data.items() if k in PatientsForm.base_fields}),
        VisitsForm(initial={k: v for k, v in form_data.items() if k in VisitsForm.base_fields})
    ]

    # 获取当前页码并分页
    page_number = request.GET.get('page')
    paginator = Paginator(forms, per_page=1)
    page = paginator.get_page(page_number)

    return render(request, 'main_patients.html', {'page': page})

如果不想在实例化时传入initial，也可以保留循环，但修改为操作表单实例的initial字典，并去掉is_bound：

def get(self, request):
    forms = [PatientsForm(), VisitsForm()]
    page_number = request.GET.get('page')
    paginator = Paginator(forms, per_page=1)
    page = paginator.get_page(page_number)

    form_data = request.session.get('form_data', {})

    for form in page.object_list:
        if form_data:
            # 修改表单实例的initial字典，而非字段的initial
            for field_name, field_value in form_data.items():
                if field_name in form.fields:
                    form.initial[field_name] = field_value
        # 移除错误的绑定状态设置：form.is_bound = True

    return render(request, 'main_patients.html', {'page': page})

2. （可选）优化POST方法的表单处理逻辑 #

当前POST方法会同时验证两个表单，但实际上每次提交只有当前页面的表单有数据，另一个表单会因缺少字段验证失败。可以改为只处理当前页面的表单，提升效率：

def post(self, request):
    page_number = request.GET.get('page', 1)
    # 根据当前页码确定要处理的表单
    if page_number == '1':
        form = PatientsForm(request.POST)
    else:
        form = VisitsForm(request.POST)

    if form.is_valid():
        # 更新session中的表单数据
        request.session.setdefault('form_data', {})
        request.session['form_data'].update(form.cleaned_data)

    # 重新生成分页对象，判断是否有下一页
    forms = [PatientsForm(), VisitsForm()]
    paginator = Paginator(forms, per_page=1)
    page = paginator.get_page(page_number)

    if page.has_next():
        return HttpResponseRedirect(f'?page={page.next_page_number()}')
    else:
        return redirect('whatever_to_be_implemented')

验证修复效果 #

修改后，返回上一页时表单会正确读取initial中的值并渲染，因为：

• 表单保持未绑定状态，Django会优先使用initial值填充字段
• 初始值设置在表单实例的initial字典中，符合Django表单的渲染逻辑

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