Flask+SQLite注册功能异常：表未检测到且数据无法写入

核心问题根源 #

1. 表初始化未在正确上下文执行：原代码未初始化数据库表，启动时触发no such table: user错误；后续添加db.create_all()但未在Flask应用上下文内执行，导致表可能创建在错误路径的数据库文件中，出现“不报错但数据无法写入”的情况。
2. 模型类命名不规范：使用小写user作为模型类名，虽语法合法，但易与变量名混淆，不符合Python命名规范。
3. SQLite相对路径歧义：sqlite:///database.db是相对当前工作目录的路径，若运行应用的目录与手动查询数据库的目录不一致，会出现“手动能查到表，但应用找不到”的矛盾。

具体修复步骤 #

1. 修正模型类命名 #

将模型类改为大驼峰命名User，同时更新代码中所有引用该类的位置：

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

2. 在应用上下文内初始化数据库表 #

修改启动代码，确保db.create_all()在Flask应用上下文执行，保证表创建在正确的数据库文件中：

if __name__ == '__main__':
    with app.app_context():
        db.create_all()
    app.run(host='0.0.0.0', port=5002, debug=True)

3. 使用绝对路径避免数据库路径歧义 #

为防止相对路径导致的数据库文件位置错误，改用绝对路径指定数据库：

import os
app = Flask(__name__)
# 使用绝对路径定位数据库文件
app.config['SQLALCHEMY_DATABASE_URI'] = f'sqlite:///{os.path.abspath("database.db")}'
db = SQLAlchemy(app)

4. 添加提交异常捕获（可选） #

在提交会话时添加异常处理，便于排查提交失败的问题：

# 创建新用户后添加异常处理
try:
    db.session.add(
        User(email=email, first_name=first_name, password=generate_password_hash(password1, method='sha256')))
    db.session.commit()
except Exception as e:
    db.session.rollback()
    print(f"注册失败原因：{str(e)}")
    return render_template('register.html', error='注册失败，请稍后重试')

修复后的完整代码 #

from flask import Flask, render_template, request, redirect, url_for
from flask_sqlalchemy import SQLAlchemy
from werkzeug.security import generate_password_hash
import os

app = Flask(__name__)
# 使用绝对路径避免数据库路径歧义
app.config['SQLALCHEMY_DATABASE_URI'] = f'sqlite:///{os.path.abspath("database.db")}'
db = SQLAlchemy(app)


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


@app.route('/')
def index():
    return render_template('index.html')


@app.route('/register', methods= ['GET', 'POST'])
def register():
    if request.method == 'POST':
        email = request.form['email']
        first_name = request.form['firstName']
        password1 = request.form.get('password1')
        password2 = request.form.get('password2')

        # 检查邮箱是否已存在
        existing_user = User.query.filter_by(email=email).first()
        if existing_user:
            return render_template('register.html', error='该邮箱已被注册')

        # 检查密码是否匹配
        if password1 != password2:
            return render_template('register.html', error='两次输入的密码不一致')

        # 创建新用户并提交
        try:
            new_user = User(
                email=email, 
                first_name=first_name, 
                password=generate_password_hash(password1, method='sha256')
            )
            db.session.add(new_user)
            db.session.commit()
            return redirect(url_for('index'))
        except Exception as e:
            db.session.rollback()
            print(f"注册失败：{str(e)}")
            return render_template('register.html', error='注册失败，请稍后重试')

    return render_template('register.html')


if __name__ == '__main__':
    with app.app_context():
        db.create_all()
    app.run(host='0.0.0.0', port=5002, debug=True)

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