Flask WTForm表单提交后数据无法写入SQLAlchemy数据库求助

问题排查与修复方案 #

1. 路由未支持POST请求 #

当前/contact路由仅配置了GET请求权限，而表单提交默认是POST请求，会直接被Flask拦截，永远无法进入form.validate_on_submit()的提交处理逻辑，自然不会执行数据库写入操作。
修复方式：修改路由装饰器的methods参数，增加POST支持：

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

2. User类__repr__方法定义错误 #

__repr__是Python类的内置魔术方法，仅接收self一个位置参数，额外定义的name、email参数会导致对象提交到数据库时触发参数不匹配报错，打断数据库写入流程。
修复方式：修正__repr__方法定义：

def __repr__(self):
    return f"{self.name},{self.email}"

3. 可选检查项 #

• 确认应用初始化阶段已经执行过db.create_all()，确保User表已在数据库中创建完成
• 可在form.validate_on_submit()逻辑块内添加打印语句，确认是否成功进入提交处理流程，也可捕获db.session.commit()抛出的异常定位数据库层面的写入错误

修正后完整代码 #

class ContactForm(FlaskForm):
    name = StringField('Name', [InputRequired()])
    email = StringField('Email Address', [InputRequired()])
    submit = SubmitField('Sign Up')


class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String, unique=False, nullable=False)
    email = db.Column(db.String, unique=False, nullable=False)

    def __init__(self, name, email):
        self.name = name
        self.email = email
    def __repr__(self):
        return f"{self.name},{self.email}"

@app.route('/contact', methods=['GET', 'POST'])
def contact():
    form = ContactForm()
    if form.validate_on_submit():
        name = form.name.data
        email = form.email.data
        user = User(name, email)
        db.session.add(user)
        db.session.commit()
        flash('Success')
        return redirect(url_for('home'))
    return render_template('contact.html', form=form)

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