Flask表单验证通过但登录代码未执行，无Flash提示问题求助

问题现象 #

登录路由实例化LoginForm后，表单验证通过的代码块未执行，既无成功也无失败的Flash提示，登录流程完全卡住。

核心问题排查与修复步骤 #

1. 表单密码字段类型错误 #

问题：登录表单中密码字段误用StringField，WTForms中密码字段需用PasswordField，否则无法正确获取提交值，直接导致表单验证失败。
修复代码：

class LoginForm(FlaskForm):
    username = StringField('Username', [validators.DataRequired()])
    password = PasswordField('Password', [validators.DataRequired()])  # 替换StringField为PasswordField

2. HTML表单结构与渲染问题 #

问题：

• 用户名的<div class="form-group">未闭合，导致表单DOM结构异常；
• 未渲染字段验证错误信息，无法直观判断验证失败原因；
• 提交按钮存在语法错误（多余逗号）。
  修复后表单核心代码：

<form method="POST" class="my-login-validation" action="{{ url_for('login') }}">
    {{ form.hidden_tag() }}
    <!-- 新增Flash消息渲染 -->
    {% with messages = get_flashed_messages(with_categories=true) %}
        {% if messages %}
            {% for category, message in messages %}
                <div class="alert alert-{{ category }}">
                    {{ message }}
                </div>
            {% endfor %}
        {% endif %}
    {% endwith %}

    <div class="form-group">
        <label for="username">Username</label>
        {{ form.username(class="form-control") }}
        {% if form.username.errors %}
            <small class="text-danger">{{ form.username.errors[0] }}</small>
        {% endif %}
    </div>  <!-- 补全闭合标签 -->

    <div class="form-group">
        <label for="password">Password</label>
        {{ form.password(class="form-control") }}
        {% if form.password.errors %}
            <small class="text-danger">{{ form.password.errors[0] }}</small>
        {% endif %}
    </div>

    <div class="form-group m-0">
        <button type="submit" class="btn btn-primary btn-block" value="Login">
            Login
        </button>
    </div>
    <div class="mt-4 text-center">
        Don't have an account? <a href="{{ url_for('register') }}">Create One</a>
    </div>
</form>

3. User类ID字段映射错误 #

问题：MongoDB文档ID字段为_id，但User类中错误读取user_data['id']，导致用户加载失败，无法维持登录状态。
修复User类：

class User(UserMixin):
    def __init__(self, user_data):
        self.id = str(user_data['_id'])  # 替换id为_id
        self.first_name = str(user_data['first_name'])
        self.last_name = str(user_data['last_name'])
        self.username = str(user_data['username'])
        self.email = str(user_data['email'])
        self.password = str(user_data['password'])

4. 调试验证失败原因 #

在登录路由中添加验证失败的调试输出，快速定位问题：

@app.route("/login/", methods=['POST', 'GET'])
def login():
    form = LoginForm()
    if form.validate_on_submit():
        # 原有登录逻辑不变
        print('form validated')
        user_data = users_collection.find_one({'username': form.username.data})
        if user_data and check_password_hash(user_data['password'], form.password.data):
            print("login good")
            user = User(user_data)
            login_user(user)
            flash('Login Successful.', 'success')
            return redirect(url_for('dashboard'))
        else:
            flash("Login Failed", 'danger')
    else:
        # 打印验证错误，用于调试
        print("Form validation errors:", form.errors)
    return render_template('login.html', form = form)

验证修复效果 #

1. 重启Flask应用，访问登录页面；
2. 输入账号密码提交，查看控制台是否输出form validated；
3. 验证通过则跳转至dashboard并显示成功提示，失败则显示对应错误信息。

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