SQLAlchemy无法自动创建数据库表，触发表不存在报错

核心报错 #

sqlalchemy.exc.OperationalError: (sqlite3.OperationalError) no such table: user

手动创建表后代码可正常运行，但自动生成逻辑失效，以下是具体问题排查与修复方案：

代码问题定位与修复 #

1. User类构造方法缩进错误 #

在website/models.py中，__init__方法未缩进在User类内部，导致类无法被正确识别为SQLAlchemy模型：

# 错误写法
class User(db.Model, UserMixin):
    email = db.Column(db.String(320), primary_key=True)
    password = db.Column(db.String(64))
    name = db.Column(db.String(150)) 
    
def __init__(self, email, password, name):
        self.email = email
        self.password = password
        self.name = name

修复后：

class User(db.Model, UserMixin):
    email = db.Column(db.String(320), primary_key=True)
    password = db.Column(db.String(64))
    name = db.Column(db.String(150)) 
    
    def __init__(self, email, password, name):
        self.email = email
        self.password = password
        self.name = name

2. 未导入模型类，导致db.create_all()无表可生成 #

在website/__init__.py的create_app函数中，必须先导入模型类，否则SQLAlchemy无法知晓需要创建哪些表：

def create_app():
    app = Flask(__name__)
    app.config['SECRET_KEY'] = 'h'
    app.config['SQLALCHEMY_DATABASE_URI'] = f'sqlite:///{DB_NAME}'
    db.init_app(app)

    # 先导入模型，确保db能识别表结构
    from .models import User
    from .auth import auth
    app.register_blueprint(auth, url_prefix='/')
 
    create_database(app)

    return app

3. 数据库路径判断逻辑不准确 #

create_database函数中硬编码instance/路径可能导致判断失效，改用Flask内置的app.instance_path获取正确的实例目录：

def create_database(app):
    db_path = path.join(app.instance_path, DB_NAME)
    if not path.exists(db_path):
        with app.app_context():
            db.create_all()
        print('Created database!')

验证步骤 #

1. 删除已生成的空database.db文件
2. 重启Flask应用，检查控制台是否输出Created database!
3. 打开instance/database.db，确认user表已自动生成

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