Python Flask SelectField预填充值未正确显示的解决方法

• WTForms的SelectField（含QuerySelectField）渲染选中状态时，只会读取字段自身绑定的data属性值，和选项列表做匹配后给对应<option>加selected属性，在模板里给字段传自定义value参数是无效的，只会给外层<select>标签加无意义的value属性，不会改变选项选中状态。
• 现有路由逻辑仅处理了POST提交时的字段赋值，GET请求访问更新页面时，没有将数据库查询到的租约值绑定到表单对应字段，表单加载时字段无有效值，自动回退选中选项列表第一个值。
• 表单类配置缺失：仅声明了租约时长的选项元组，没有实例化lease_duration字段为SelectField类型并绑定选项，字段逻辑不完整。

按以下三步修改即可：

1. 补全表单类定义，正确声明SelectField并绑定选项

from wtforms import SelectField
# 其余原有导入保持不变

class Lease_Update_Form(FlaskForm):
    tenant_id = QuerySelectField(query_factory=get_tenant, get_label='display_name')
    property_id = QuerySelectField(query_factory=get_property, get_label='display_name')
    lease_start_date = DateField(label='Lease Start Date')
    lease_duration_choices = ("1 week", "4 weeks", "3 months", "6 months", "12 months", "24 months", "36 months")
    # 正确实例化SelectField，选项格式为(存储值, 显示文本)
    lease_duration = SelectField(label="Lease Duration", choices=[(item, item) for item in lease_duration_choices])
    # 其余下拉字段比如rental_frequency按相同规则补全定义即可

2. 修改路由逻辑，GET请求时给表单绑定预填充值，POST提交时走标准表单校验流程

from flask import redirect, url_for
# 其余原有导入保持不变

@app.route('/leases/update/<int:lease_id>', methods=["GET","POST"])
def get_lease_update(lease_id):
    lease_update_form = Lease_Update_Form()
    lease_to_update = Leases_Model.query.get_or_404(lease_id)

    # GET请求加载页面时，将数据库值绑定到表单字段
    if request.method == "GET":
        lease_update_form.lease_duration.data = lease_to_update.lease_duration
        # 其余需要预填充的字段按相同格式赋值即可，例如：
        # lease_update_form.lease_start_date.data = lease_to_update.lease_start_date
        # lease_update_form.rental_amount.data = lease_to_update.rental_amount

    # POST提交且表单校验通过时，保存数据
    if lease_update_form.validate_on_submit():
        lease_to_update.lease_start_date = lease_update_form.lease_start_date.data
        lease_to_update.lease_duration = lease_update_form.lease_duration.data
        lease_to_update.rental_frequency = lease_update_form.rental_frequency.data
        lease_to_update.rental_amount = lease_update_form.rental_amount.data
        lease_to_update.lease_deposit_paid_amount = lease_update_form.lease_deposit_paid_amount.data
        lease_to_update.lease_deposit_paid_date = lease_update_form.lease_deposit_paid_date.data
        lease_to_update.lease_notes = lease_update_form.lease_notes.data
        lease_to_update.first_payment_date = lease_update_form.first_payment_date.data
        db.session.commit()
        # 提交后重定向，避免表单重复提交
        return redirect(url_for("get_lease_update", lease_id=lease_id))
    
    # 统一渲染模板，GET加载、POST校验失败都会走到这里
    return render_template("lease_details.html", lease_update_form=lease_update_form, lease_to_update=lease_to_update)

3. 修改模板代码，删除无效的自定义value传参

<p>
  {{ lease_update_form.lease_duration.label }}<br>
  {{ lease_update_form.lease_duration(class="form-control") }}
</p>

给SelectField绑定预填充值时，赋值给data的内容必须和选项列表中对应选项的存储值完全匹配（包括数据类型、文本内容），否则会匹配失败，依旧默认选中第一个选项。如果是QuerySelectField，直接给data赋值对应的数据库模型实例即可自动匹配选中。

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