Flask+WTForms+SQLAlchemy：SelectMultipleField编辑时无法回显选中值

问题根源 #

核心问题出在字段数据类型不匹配和表单初始化顺序错误：

1. SelectMultipleField 的 choices 需要是 (value_str, label) 格式的元组列表，但绑定的 Entry.supported_tests 是 SupportedTests 对象列表，WTForms 无法自动将对象转换为匹配 choices 的值。
2. 先绑定 obj=Entry 再设置 choices，导致 WTForms 初始化时无法根据未加载的选项匹配已选值。

具体修复步骤 #

1. 调整视图函数的表单初始化顺序

先设置 choices，再根据请求方法处理表单数据绑定：

@app.route('/setup', methods=['GET', 'POST'])
def doSetup():
    Entry = dal.Testers.query.get(int(EditID))
    Form = forms.MyForm()
    
    # 第一步：先填充下拉选项（确保get_active_tests()返回[(test_value, test_name), ...]格式）
    Form.supported_tests.choices = get_active_tests()

    if request.method == 'GET':
        # GET请求（编辑页面）：手动提取已选测试的value值，设置给表单字段
        # 从SupportedTests对象中取出test字段，注意要和choices里的value类型一致（比如字符串）
        selected_values = [st.test for st in Entry.supported_tests]
        Form.supported_tests.data = selected_values
    else:
        # POST请求：用提交的数据填充表单
        Form = forms.MyForm(request.form)
        Form.supported_tests.choices = get_active_tests()

    # 处理表单提交
    if Form.validate_on_submit():
        # 先清空旧的关联数据
        Entry.supported_tests.clear()
        # 遍历选中的value，创建新的SupportedTests对象
        for test_val in Form.supported_tests.data:
            new_test = dal.SupportedTests(test=test_val, tester_id=Entry.id)
            Entry.supported_tests.append(new_test)
        # 填充其他字段并保存
        Form.populate_obj(Entry)
        db.session.commit()
        # 这里可以添加跳转或成功提示

    print('已保存的测试值:', [st.test for st in Entry.supported_tests])
    return render_template('setup.html', form=Form)

2. 确保 get_active_tests() 返回正确格式

get_active_tests() 必须返回字符串值+显示名称的元组列表，示例：

def get_active_tests():
    # 从数据库或其他来源获取可用测试
    return [
        ("1.0", "Test One"),
        ("1.2", "Test Two"),
        ("1.5", "Test Five")
    ]

注意：value 必须和 SupportedTests.test 字段的类型完全一致（你的模型里是 String，所以value要用字符串）。

解决你遇到的错误 #

• "cannot unpack non-iterable"：直接用 SupportedTests 对象作为 choices 不符合要求，WTForms 需要的是 (value, label) 元组，必须提取对应字段。
• "'str' object has no attribute '_sa_instance_state'"：直接把选中的字符串赋值给 Entry.supported_tests 错误，它需要的是 SupportedTests 对象列表，提交时必须手动创建对象并添加到关系中。

额外注意 #

• 仅在 GET 编辑模式下手动设置 Form.supported_tests.data，不要在 POST 请求中覆盖该值，否则会丢失用户提交的新内容。
• 检查 Entry.supported_tests 中的 test 字段值，确保和 choices 里的 value 完全匹配（包括大小写、类型，避免字符串"1.0"和浮点数1.0的差异）。

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