WTForms提交后FieldList中子表单条目消失问题排查

我在Python中实现了一个用FieldList填充子表单数据的网页。首次渲染页面时，表单能正确加载两个子表单条目，但提交SubmitField后，即便每次传入的runList字典内容完全一致，仍会有一个子表单条目消失。

相关代码如下：

from flask_wtf import FlaskForm
from wtforms import SubmitField, StringField, FieldList, FormField

class RunControl(FlaskForm):
    start = SubmitField('Start Run')
    delete = SubmitField('Delete Run')
    plot = SubmitField('Plot')
    runID = StringField('Run ID', render_kw={'readonly': True})
    imageURL = StringField('Image URL', render_kw={'readonly': True})

class RunsForm(FlaskForm):
    runs = FieldList(FormField(RunControl))
    stop = SubmitField('Stop Run')
    activeRunID = StringField('Active Run ID',  render_kw={'readonly': True})
    activeDescr = StringField('Active Run Description', render_kw={'readonly': True})

@app.route('/', methods=['GET', 'POST'])
def index():
    runList = getRunList()
    runsForm = RunsForm(runs=runList, min_entries=len(runList))

每次执行视图函数时，runList始终包含两个元素，但创建RunsForm后打印runsForm.runs长度发现：首次显示页面时长度为2，提交SubmitField后再次调用视图函数时长度变为1。

核心原因 #

1. POST请求的表单数据优先级更高：Flask-WTF在处理POST请求时，会优先使用request.form中的数据填充表单，你传入的runList参数会被忽略。当点击子表单内的SubmitField（如start/delete）时，浏览器只会提交被点击按钮所在子表单的字段，另一个子表单的字段不会出现在POST数据中，导致FieldList仅保留1个条目。
2. 对min_entries的误解：min_entries的作用是控制渲染时至少显示多少个空条目，当表单已有请求数据时，它不会强制覆盖请求中的条目数量。

解决方法 #

需要区分GET和POST请求的处理逻辑，确保POST请求时能强制保留所有子表单条目：

方法一：手动重置FieldList条目 #

from flask import request, render_template

@app.route('/', methods=['GET', 'POST'])
def index():
    runList = getRunList()
    if request.method == 'GET':
        runsForm = RunsForm(runs=runList, min_entries=len(runList))
    else:
        # 先基于POST数据创建表单
        runsForm = RunsForm()
        # 清空原有条目，重新填充runList数据
        runsForm.runs.entries = []
        for run_data in runList:
            runsForm.runs.append_entry(run_data)
        # 保留非FieldList字段的POST数据（如stop按钮状态）
        runsForm.process(request.form)
    
    # 后续处理表单验证等逻辑
    return render_template('index.html', form=runsForm)

方法二：用完整数据覆盖POST请求 #

from flask import request, render_template

@app.route('/', methods=['GET', 'POST'])
def index():
    runList = getRunList()
    full_data = {'runs': runList}
    
    if request.method == 'POST':
        # 合并POST中的非FieldList字段数据
        for key in request.form:
            if not key.startswith('runs-'):
                full_data[key] = request.form[key]
    
    # 用完整数据初始化表单，强制覆盖请求数据
    runsForm = RunsForm(data=full_data, min_entries=len(runList))
    
    # 后续处理
    return render_template('index.html', form=runsForm)

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