WTForms将选项转为字符串：SQLAlchemy动态生成SelectField遇序列化问题

我之前也碰到过一模一样的情况，原来的wtforms.ext.*包确实已经被弃用了，不过别担心，现在有靠谱的替代方案，也可以手动处理避开这个问题，下面给你两种实用思路：

1. 使用官方替代的wtforms_sqlalchemy扩展里的QuerySelectField #

原来的QuerySelectField已经迁移到独立的wtforms-sqlalchemy包了，先安装它：

pip install wtforms-sqlalchemy

然后在表单里直接用这个字段，不用手动在__init__里折腾choices，它会自动帮你处理数据库查询和对象映射，示例代码如下：

from flask_wtf import FlaskForm
from wtforms_sqlalchemy.fields import QuerySelectField
from your_app.models import User  # 导入你的User模型

def get_users():
    # 定义查询工厂函数，返回所有用户的查询结果
    return User.query.all()

class ChangeAccountForm(FlaskForm):
    # 使用QuerySelectField，指定查询逻辑和显示的标签字段
    user = QuerySelectField(
        '选择用户',
        query_factory=get_users,
        get_label=lambda user: user.username  # 这里填你想展示的用户字段，比如username或email
    )

这样生成的表单会自动把用户的username作为显示文本，背后用用户主键作为表单提交的实际值，提交后直接通过form.user.data就能拿到完整的User对象，不用自己再额外查询，非常省心。

2. 手动处理SelectField的choices（不依赖扩展） #

如果你不想额外装扩展，也可以手动构造符合要求的choices元组，核心思路是用用户的主键（比如id）作为选项值，用用户的显示字段（比如username）作为显示文本，彻底避开对象被转成字符串的问题：

from flask_wtf import FlaskForm
from wtforms import SelectField
from your_app.models import User

class ChangeAccountForm(FlaskForm):
    user = SelectField('选择用户', choices=[])

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 动态生成choices：(用户id, 显示文本)
        self.user.choices = [(user.id, user.username) for user in User.query.all()]

表单提交后，你拿到的form.user.data是用户的id字符串，只需再查一次数据库就能拿到对应的User对象：

@app.route('/change-account', methods=['POST'])
def change_account():
    form = ChangeAccountForm()
    if form.validate_on_submit():
        user_id = form.user.data
        selected_user = User.query.get(int(user_id))
        # 接下来处理选中的用户对象即可
        ...

为什么原来的方法会出问题？ #

WTForms的SelectField要求choices是**(value, label)**的元组，其中value会被当作字符串处理（因为表单提交的数据都是字符串类型）。如果你直接把User对象作为value，WTForms会自动调用str()或repr()把它转成字符串，提交后你拿到的只是对象的字符串表示，根本没法还原成User对象，所以用主键作为中间值才是可靠的方案。

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