Flask-WTF 0.14 联系表单‘二选一’验证实现求助

这个问题我之前也碰到过！单靠WTForms自带的字段级验证确实搞不定跨字段的“或”条件，得用表单级的自定义验证来实现。我给你一步步拆解解决方案：

1. 修改Forms.py：添加表单级验证 #

首先，我们需要在你的表单类里重写validate方法，先确保单个字段的格式验证通过，再检查“邮箱/手机号至少填一个”的条件。注意要把邮箱和手机号的必填验证改成Optional()，因为我们不需要强制必填，只是二选一。

from flask_wtf import FlaskForm
from wtforms import StringField, TextAreaField, SubmitField
from wtforms.fields.html5 import EmailField
from wtforms.validators import Optional, InputRequired, Regexp, Email

class ContactForm(FlaskForm):
    # 邮箱：可选，但如果填了必须是有效格式
    email = EmailField('邮箱', validators=[Optional(), Email(message='请输入有效的邮箱地址')])
    # 手机号：可选，但如果填了必须符合国内手机号格式（你可以根据需求调整正则）
    phone = StringField('手机号', validators=[
        Optional(),
        Regexp(r'^1[3-9]\d{9}$', message='请输入有效的11位手机号')
    ])
    # 留言是必填项
    message = TextAreaField('留言内容', validators=[InputRequired(message='留言不能为空')])
    submit = SubmitField('提交')

    def validate(self, extra_validators=None):
        # 先调用父类的validate方法，确保单个字段的格式验证通过
        if not super().validate(extra_validators):
            return False
        
        # 核心逻辑：检查邮箱和手机号是否至少有一个不为空
        if not self.email.data.strip() and not self.phone.data.strip():
            # 给两个字段都添加错误提示，方便用户看到
            self.email.errors.append('邮箱或手机号至少填写一个')
            self.phone.errors.append('邮箱或手机号至少填写一个')
            return False
        
        # 所有验证通过
        return True

2. app.py中的表单处理（无需大改） #

你的提交逻辑和之前差不多，只要确保调用form.validate_on_submit()就会自动触发我们自定义的验证：

from flask import Flask, render_template, redirect, url_for, flash
from forms import ContactForm

app = Flask(__name__)
app.config['SECRET_KEY'] = 'your-secret-key-here'  # 记得替换成你的密钥

@app.route('/contact', methods=['GET', 'POST'])
def contact():
    form = ContactForm()
    if form.validate_on_submit():
        # 这里写你的邮件发送逻辑，比如获取form.email.data和form.phone.data
        flash('留言已提交，我们会尽快与您联系！', 'success')
        return redirect(url_for('contact'))
    return render_template('contact.html', form=form)

3. 模板中显示错误提示 #

在你的contact.html模板里，记得给邮箱和手机号字段添加错误显示，这样用户能看到我们自定义的提示：

<form method="POST">
    {{ form.hidden_tag() }}
    
    <div class="form-group">
        {{ form.email.label(class="form-label") }}
        {{ form.email(class="form-control") }}
        {% for error in form.email.errors %}
            <small class="text-danger">{{ error }}</small>
        {% endfor %}
    </div>

    <div class="form-group">
        {{ form.phone.label(class="form-label") }}
        {{ form.phone(class="form-control") }}
        {% for error in form.phone.errors %}
            <small class="text-danger">{{ error }}</small>
        {% endfor %}
    </div>

    <div class="form-group">
        {{ form.message.label(class="form-label") }}
        {{ form.message(class="form-control", rows=5) }}
        {% for error in form.message.errors %}
            <small class="text-danger">{{ error }}</small>
        {% endfor %}
    </div>

    {{ form.submit(class="btn btn-primary") }}
</form>

为什么你之前的方案没生效？ #

大概率是因为你用了字段级的验证器，而字段级验证只能针对单个字段，无法跨字段判断“或”条件。只有表单级的自定义验证才能访问所有字段的数据，实现这种跨字段的逻辑。

另外要注意：如果之前给邮箱/手机号加了InputRequired()，一定要改成Optional()，否则单个字段的必填验证会先触发，覆盖我们的二选一逻辑。

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