Flask SQLAlchemy如何在默认及SQLALCHEMY_BINDS绑定库创建模型并建表

你手动创建sessionmaker生成独立会话的写法，脱离了Flask-SQLAlchemy内置维护的模型元数据映射体系，会话无法识别已经定义的模型结构，自然无法在对应数据库中生成数据表。
正确实现逻辑如下，根据你的业务场景选对应方式即可： #

场景1：模型已固定绑定对应数据库 #

如果你的不同数据库对应固定的模型集，只需要在模型类中声明__bind_key__参数指定绑定的数据库键，框架会自动处理路由：

# 默认库模型，无需声明__bind_key__
class SystemConfig(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    config_key = db.Column(db.String(128))

# 绑定到指定bind的模型
class BusinessLog(db.Model):
    __bind_key__ = "log_db"
    id = db.Column(db.Integer, primary_key=True)
    log_content = db.Column(db.Text)

建表时直接调用内置方法即可，不需要手动创建会话、遍历引擎，db.create_all()会自动扫描默认库+所有声明过的bind库，给对应数据库创建匹配的模型表：

# 必须在应用上下文中执行
with app.app_context():
    db.create_all()

场景2：动态多租户场景（所有bind共用一套模型） #

如果是多租户架构，所有配置在SQLALCHEMY_BINDS中的租户库使用完全相同的模型结构，不需要给模型固定绑定__bind_key__，按如下逻辑执行建表：

from flask import current_app

with current_app.app_context():
    # 第一步：先给默认数据库建表
    db.create_all()

    # 第二步：遍历所有配置的租户bind，逐个给对应租户库建表
    for tenant_bind_key in current_app.config["SQLALCHEMY_BINDS"].keys():
        # 获取对应租户的数据库引擎
        tenant_engine = db.get_engine(bind=tenant_bind_key)
        # 直接使用框架维护的全局模型元数据执行建表，不需要手动创建session
        db.metadata.create_all(bind=tenant_engine)

注意事项 #

• 所有需要建表的模型，必须在执行create_all前完成导入，否则元数据无法扫描到表结构，会出现漏建表的问题，建议在应用初始化阶段统一导入所有模型类。
• Flask-SQLAlchemy 3.0+版本中，db.get_engine()在应用上下文内不需要传入current_app参数，直接传入bind值即可。
• 所有数据库操作必须在应用上下文内执行，否则会触发上下文异常。
• 不要手动实例化独立的sessionmaker生成会话做建表操作，独立会话不会加载框架维护的模型元数据，无法识别表结构。

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