Flask - wtforms：验证总是错误的

Question

首先，我是 python 和 Flask 的新手，如果我的问题很愚蠢，我很抱歉。我搜索它，但从未找到答案（我猜这应该是一个“简单”的答案）。

我想在我的网站中添加一个联系页面，我找到了this tutorial，所以我关注了它。 在表单验证之前一切正常。我只使用 Required 并且 form.validate() 总是返回 false。如果我不碰我的代码，并且我删除了表单类中的每个必需项，它就可以正常工作，form.validate() 返回 true。

我真的不明白为什么，我读了很多应该使用 validate_on_submit()，但是如果我使用它会出现错误：*'ClassName' object has no attribute 'validate_on_submit'*

以下是代码的相关部分：

Index.py

@app.route('/contact', methods=['GET','POST'])
def contact():
form = ContactForm()

if request.method == 'POST':
    if form.validate() == False:
        flash('All Fields are required.')
        return render_template('contact.html', form=form)
    else:
        return 'Form posted'
elif request.method == 'GET':
    return render_template('contact.html', form=form)

forms.py

from wtforms import Form, TextField, TextAreaField, SubmitField, validators,ValidationError 

class ContactForm(Form):
  name = TextField("Name", [validators.Required()])
  email = TextField("Email")
  subject = TextField("Subject")
  message = TextAreaField("Message")
  submit = SubmitField("Send")

contact.html

<div id="contact">
    {% for message in get_flashed_messages() %}
        <div class="flash">{{ message }}</div>
    {% endfor %}
  <form action="{{ url_for('contact') }}" method=post>

    {{ form.name.label }}
    {{ form.name }}

    {{ form.email.label }}
    {{ form.email }}

    {{ form.subject.label }}
    {{ form.subject }}

    {{ form.message.label }}
    {{ form.message }}

    {{ form.submit }}
  </form>
 </div>

即使我在名称字段中写了一些东西，我也从未收到“已发布表单”字符串。

提前致谢，

Answer 1

您必须使用请求中的值初始化表单实例：

from flask import request

@app.route('/contact', methods=['GET','POST'])
def contact():
    form = ContactForm(request.form)
    if request.method == "POST" and form.validate():
        # do something with form
        # and probably return a redirect
    return render_template("contact.html", form=form)

这是一个比您在问题中链接的更好的教程：http://flask.pocoo.org/docs/patterns/wtforms/。

查看教程中的模板渲染代码，确保渲染表单字段错误。如果表单已发布但未验证，则代码将落入render_template，并且表单实例包含字段验证错误（同样，有关详细信息，请参阅教程和 WTForms 文档）。

Answer 2

当我按照 Miguel Grinberg 的“Flask Web Development”一书中的演示代码测试登录表单时，我总是失败 form.validate_on_submit()。所以我觉得我应该想办法调试一下。

我采用的调试方法是将以下代码添加到 app/auth/views.py：

flash(form.errors)

然后当我运行到登录页面时它显示了罪魁祸首：

errors={'csrf_token': ['CSRF token missing']}

所以我建议使用 form.errors 消息来调试。

Answer 3

刚刚遇到这个问题，解决方法是在模板中的表单正下方添加hidden_tag：

...
<form action="{{ url_for('contact') }}" method=post>
{{ form.hidden_tag() }}
...

Answer 4

作为@Paul Vergeev，只需添加：

<form action="{{ url_for('contact') }}" method=post>
{{ form.csrf_token }}

这是必需的，因为您的表单包含验证器，因此在您的 html 表单中添加了“隐藏”类型的“输入”。如果您的 html 中没有此隐藏标记，验证器将无法验证您的用户输入，并且验证结果将始终为 False。

{{ form.hidden_tag() }}

将在您的 html 代码中包含所有隐藏的输入字段；但它们不会显示在页面上。

{{ form.csrf_token }}

将在您的 html 代码中仅包含隐藏的 csrf_token 输入字段；但它们不会显示在页面上。

还有一件事情要做：您必须配置应用的SECRET_KEY。通过将app.config["SECRET_KEY"] = "a secret key you won't forget" 包含在应用程序初始化的下方（即在app = Flask(__name__) 之后）来执行此操作。

所有这些都是 WTForms 验证器保护您的网站免受 CSRF（通常发音为 c-surf）的一种方式。您还可以阅读更多关于 CSRF 的信息here。