使用Flask-SQLAlchemy创建数据库报错：create_all()不支持app参数

问题场景 #

开发基于Flask-SQLAlchemy的Flask应用时，执行数据库创建操作触发错误，代码及报错信息如下：

原代码 #

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()

def create_app():
    app = Flask(__name__)
    app.config["SQLALCHEMY_DATABASE_URI"] = "sqlite:///project.db"
    db.init_app(app)

    from . import models

    create_database(app)
    return app

def create_database(app):
    if not path.exists("website/project.db"):
        db.create_all(app=app)
        print("created database")

报错信息 #

SQLAlchemy.create_all() got an unexpected keyword argument 'app'

修复方案 #

该报错是因为Flask-SQLAlchemy 3.x版本已废弃create_all()方法的app参数，需通过应用上下文执行数据库创建操作，具体修复步骤如下：

1. 补充导入path模块（原代码未导入但已使用）
2. 使用app.app_context()上下文管理器包裹db.create_all()调用

修改后的完整代码 #

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from os import path  # 补充导入path模块

db = SQLAlchemy()

def create_app():
    app = Flask(__name__)
    app.config["SQLALCHEMY_DATABASE_URI"] = "sqlite:///project.db"
    db.init_app(app)

    from . import models

    create_database(app)
    return app

def create_database(app):
    # 根据项目实际结构确认数据库文件路径
    if not path.exists("website/project.db"):
        with app.app_context():
            db.create_all()
        print("created database")

补充说明 #

• Flask-SQLAlchemy 3.x及以后版本，所有依赖应用配置的操作（如创建表、查询数据）都必须在应用上下文环境中执行
• 旧版教程（针对2.x版本）中直接传递app参数的写法已被移除，需适配新版本API
• 确保models模块中已正确定义ORM模型，否则create_all()不会生成对应的数据库表

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