Flask应用无法生成班级代码：表单提交异常及数据未存入数据库问题排查求助

大家好，我正在开发一个Flask应用，员工可以在其中生成班级代码。我已经搭建了一个表单来处理班级代码（含描述）的提交，但现在无法成功生成班级代码，具体问题如下：

问题现象 #

• 尝试生成班级代码时，表单无法正确提交
• 没有看到任何错误提示，但班级代码并未保存到数据库
• 检查数据库后，没有新增任何记录
• 我使用Flask-WTF处理表单，Flask-SQLAlchemy操作数据库

相关代码 #

路由代码 #

@main.route('/employee/dashboard', methods=['GET', 'POST'])
@login_required
def employee_dashboard():
    if current_user.role != 'employee':
        flash('You must be an employee to access this page.', 'danger')
        return redirect(url_for('main.dashboard'))

    form = EmployeeForm()
    class_codes = ClassCode.query.order_by(ClassCode.created_at.desc()).all()

    if form.validate_on_submit():
        code = form.code.data
        description = form.description.data

        # Check for duplicates
        if ClassCode.query.filter_by(code=code).first():
            flash('Class code already exists!', 'danger')
        else:
            new_code = ClassCode(code=code, description=description)
            db.session.add(new_code)
            db.session.commit()
            flash('Class code generated successfully!', 'success')
            return redirect(url_for('main.employee_dashboard'))

    return render_template('employee_dashboard.html', form=form, class_codes=class_codes)

班级代码模型 #

class ClassCode(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    code = db.Column(db.String(50), unique=True, nullable=False)
    description = db.Column(db.String(100), nullable=True)
    created_at = db.Column(db.DateTime, default=datetime.utcnow)

    def __repr__(self):
        return f'<ClassCode {self.code}>'

表单定义 #

class EmployeeForm(FlaskForm):
    code = StringField(
        'Class Code',
        validators=[DataRequired(), Length(max=20, message="Code must be 20 characters or less.")],
    )
    description = StringField(
        'Description',
        validators=[DataRequired(), Length(max=255, message="Description must be 255 characters or less.")],
    )
    submit = SubmitField('Generate Code')

HTML模板 #

{% extends 'base.html' %}

{% block content %}
<div class="container mt-4">
  <h2>Employee Dashboard</h2>

  <!-- Form for generating class code -->
  <form method="POST">
    {{ form.hidden_tag() }}  <!-- Include CSRF token -->
    <div class="row mb-3">
      <label for="code" class="col-sm-2 col-form-label">Class Code:</label>
      <div class="col-sm-10">
        {{ form.code(class="form-control") }}  <!-- Render form field -->
      </div>
    </div>

    <div class="row mb-3">
      <label for="description" class="col-sm-2 col-form-label">Description:</label>
      <div class="col-sm-10">
        {{ form.description(class="form-control") }}  <!-- Render form field -->
      </div>
    </div>

    <div class="row">
      <div class="col-sm-10 offset-sm-2">
        <button type="submit" class="btn btn-primary">{{ form.submit.label }}</button>
      </div>
    </div>
  </form>

  <!-- Display existing class codes -->
  <h3 class="mt-4">Generated Class Codes</h3>
  <ul class="list-group">
    {% for code in class_codes %}
      <li class="list-group-item d-flex justify-content-between align-items-center">
        {{ code.code }} - {{ code.description }}
        <span class="badge bg-info">{{ code.created_at.strftime('%Y-%m-%d') }}</span>
      </li>
    {% endfor %}
  </ul>
</div>
{% endblock %}

我的疑问 #

• 为什么表单无法正确提交？
• 为什么班级代码没有保存到数据库？
• 我可能遗漏了什么？或者有哪些额外的调试步骤可以用来排查这个问题？

我已经尝试的排查步骤 #

1. 表单验证检查
   • 我通过添加调试打印语句，检查form.validate_on_submit()是否返回True，发现表单似乎没有通过验证，但不知道具体原因。
2. CSRF令牌检查
   • 我确认HTML中已经通过{{ form.hidden_tag() }}包含了CSRF令牌。
3. 数据库重复项查询
   • 我使用ClassCode.query.filter_by(code=code).first()检查重复的班级代码，并且打印了查询结果，但即使是已存在的代码，它也没有检测到重复。
4. 数据库更新检查
   • 我检查了数据库，但提交表单后没有新增任何ClassCode记录。
5. 错误日志检查
   • 我启用了Flask调试模式（app.debug = True），并查看控制台错误，但没有发现任何异常。
6. 重定向行为检查
   • 我原本期望表单成功生成班级代码后，会重定向回仪表盘（return redirect(url_for('main.employee_dashboard'))），但页面没有变化，也没有显示任何flash提示消息。

预期结果 #

填写表单并点击“Generate Code”按钮后，我期望：

1. 表单数据（班级代码和描述）能够通过验证
2. 数据库中会新增一条ClassCode记录
3. 如果班级代码重复，会显示提示消息Class code already exists!
4. 如果班级代码保存成功，会显示成功提示消息Class code generated successfully!，并且新的班级代码会显示在下方的列表中
5. 页面会刷新，新的班级代码会出现在已生成的班级代码列表里

备注：内容来源于stack exchange，提问作者user28691752