Flask-WTF中FieldList嵌套QuerySelectField无法设置默认值问题

我之前也碰到过Flask-WTF里FieldList嵌套QuerySelectField设置默认值不生效的坑，结合你的代码来看，主要有两个关键问题需要解决：

首先，先修正一个容易忽略的笔误 #

你表单里定义的FieldList字段名是t_job_crewing_roles，但辅助函数里赋值时写的是t_jobs_crewing_roles（多了一个s）！这就导致你辛辛苦苦创建的roles_items根本没关联到表单的实际字段上，页面渲染的还是表单默认的空列表，自然看不到选中状态。

先把这行代码改对：

job.review_form.t_job_crewing_roles = roles_items

然后，解决默认值同步的问题 #

即使字段名对了，直接给FieldList赋值条目后，Flask-WTF不会自动把default值同步到字段的data属性——而页面渲染选中状态靠的是data，不是default。这里有两种靠谱的解决方式：

方式一：手动同步默认值到data

在创建每个CrewingRoleEntryForm实例时，设置完目标实例后直接同步到data，或者调用process_data方法：

roles_items = []
for p in ast.literal_eval(form.t_job_crewing_roles_dict.data):
    select_entry = CrewingRoleEntryForm()
    select_entry.role.id = f"role_{p['id']}"
    select_entry.role.label = p['id']
    role_instance = Jobs_crewing_roles.query.filter_by(roles_abbreviation=p['role']).first()
    # 直接赋值data，或者调用select_entry.role.process_data(role_instance)
    select_entry.role.data = role_instance
    roles_items.append(select_entry)
job.review_form.t_job_crewing_roles = roles_items

方式二：用FieldList的append_entry方法（更推荐）

Flask-WTF的FieldList自带append_entry方法，它能接收一个字典来自动填充表单字段，不需要手动处理default或process，代码更简洁：

# 先清空现有条目（如果需要的话）
job.review_form.t_job_crewing_roles.entries = []
for p in ast.literal_eval(form.t_job_crewing_roles_dict.data):
    role_instance = Jobs_crewing_roles.query.filter_by(roles_abbreviation=p['role']).first()
    # 传入字典，键对应CrewingRoleEntryForm里的字段名
    job.review_form.t_job_crewing_roles.append_entry({
        'role': role_instance
    })
    # 如果你需要自定义id和label，建议在模板里处理，或者自定义QuerySelectField的渲染逻辑

这样append_entry会自动把role_instance赋值给字段的data，页面渲染时就会正确选中对应的选项了。

最后解释下调试的疑惑 #

你在调试器里看到default是正确的，但页面没选中，是因为你调试的是roles_items里的实例，而之前因为字段名笔误，这些实例根本没被加到表单的FieldList里；就算字段名对了，default只是字段的备用值，只有当data为空时才会生效，手动添加的条目需要主动把目标实例同步到data才行。

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