Flask & WTForms触发ValidationError时执行中断未返回表单错误

你代码有两个核心错误，直接导致ValidationError未被捕获中断程序：

• WTForm自定义行内验证方法必须遵循validate_<绑定字段名>的命名规则，才会被表单内置的validate()流程自动捕获抛出的ValidationError，存入表单错误集合。你写的validate_phone_and_country不符合命名规范，WTForm不会自动处理该方法抛出的异常。
• 你选择手动调用这个自定义验证方法，却没有在调用处捕获方法抛出的ValidationError，异常直接向上穿透到Flask框架，自然触发调试页报错中断。
• 另外你的视图代码存在缩进错误，数据库事务逻辑的位置和验证分支的判断也有逻辑漏洞。

1. 修正表单验证逻辑 #

关联多个字段的校验推荐直接重写表单的全局validate方法，该方法会在所有单字段验证完成后自动执行，不需要手动调用：

from wtforms import ValidationError
from flask_wtf import FlaskForm
from wtforms import StringField, HiddenField
from wtforms.validators import DataRequired, Length
import phonenumbers

class PhoneForm(FlaskForm):
    phone_number = StringField('Phone Number', validators=[DataRequired(), Length(max=15)])
    country_code = HiddenField('')

    def validate(self, extra_validators=None):
        # 先执行内置的单字段验证（DataRequired、Length等规则）
        base_valid = super().validate(extra_validators=extra_validators)
        if not base_valid:
            return False
        
        # 执行手机号+国家码联合校验
        try:
            p = phonenumbers.parse(self.phone_number.data, self.country_code.data)
            if not phonenumbers.is_valid_number(p):
                self.phone_number.errors.append('Invalid Phone Number')
                return False
        except (phonenumbers.phonenumberutil.NumberParseException, ValueError):
            self.phone_number.errors.append('Invalid Phone Number')
            return False
        
        return True

2. 修正视图层处理逻辑 #

不要手动调用自定义验证方法，直接用FlaskForm封装好的validate_on_submit()方法作为验证入口，该方法会自动判断请求方法、执行所有验证规则、收集错误信息，同时修正缩进和逻辑分支：

phone_form = PhoneForm()
if phone_form.validate_on_submit():
    try:
        phone = PhoneRecord()
        phone_form.populate_obj(phone)
        db.session.add(phone)
        db.session.commit()
        flash('Phone number successfully changed.', 'success')
        return redirect(url_for('user.home'))
    except Exception as e:
        db.session.rollback()
        flash('There was a problem saving your information. Please try again.', 'danger')
else:
    flash('The phone number you entered was invalid. Please try again.', 'warning')

return render_template("phone_form.html", form=phone_form)

• 如果你更倾向于用字段级验证，也可以写命名为validate_phone_number的方法，在方法内获取self.country_code.data做联合校验，直接抛出ValidationError即可，异常会被自动绑定到phone_number字段的错误列表中，不需要手动追加errors。
• 模板中可以直接遍历form.phone_number.errors渲染字段对应的错误提示，和flash的全局提示配合展示即可。

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