Flask使用WTForms验证器报错：validate()存在意外参数extra_validators

问题代码 #

from flask import Flask, render_template, session, redirect, url_for
from flask_bootstrap import Bootstrap
from flask_moment import Moment
from flask_wtf import FlaskForm
from wtforms import StringField, SubmitField
from wtforms.validators import DataRequired

app = Flask(__name__)
class NameForm(FlaskForm):
    name = StringField('What is your name?', validators=[DataRequired()])
    submit = SubmitField('Submit')


@app.route('/', methods=['GET', 'POST'])
def index():
    form = NameForm()
    if form.validate_on_submit():
        session['name'] = form.name.data
        return redirect(url_for('index'))
    return render_template('index.html', form=form, name=session.get('name'))

报错信息 #

TypeError: validate() got an unexpected keyword argument 'extra_validators'

场景说明 #

我是Flask新手，在index.html中通过{{ wtf.quick_form(form) }}渲染表单，提交字段内容时触发上述错误，请问是否需要修改NameForm类，或该如何解决此问题？

解决方案 #

这个错误是Flask-WTF与WTForms版本不兼容导致的：新版本WTForms（3.0+）调整了validate()方法的参数定义，但旧版Flask-WTF仍在传递extra_validators参数，从而触发类型错误。不需要修改NameForm类，按以下方式解决：

方法1：匹配兼容版本（推荐） #

• 若使用的是WTForms 3.0+，升级Flask-WTF到1.1.0及以上版本：

pip install --upgrade flask-wtf

• 若不想升级Flask-WTF，可将WTForms降级到2.3.x版本：

pip install wtforms==2.3.3

方法2：补充必填配置 #

另外你的代码还缺少Flask-WTF表单验证必需的SECRET_KEY，需要添加到代码中：

app.config['SECRET_KEY'] = 'your-custom-secret-key'  # 生产环境请使用安全的随机密钥

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