如何让Flask-Migrate正确读取应用配置连接目标MSSQL数据库

问题核心表现 #

• 执行flask db init无任何报错，修改migrations/env.py配置指定MS SQL Server目标Schema后，执行flask db migrate触发异常
• 控制台输出警告：未检测到SQLALCHEMY_DATABASE_URI或SQLALCHEMY_BINDS配置，默认使用sqlite:///:memory:作为数据库地址
• 最终抛出异常：sqlite3.OperationalError: unknown database "MyProjectDB"
• 项目采用应用工厂模式，在create_app()中通过app.config.from_object('app.local_settings')加载本地配置，配置文件中已正确配置MSSQL连接串：SQLALCHEMY_DATABASE_URI = "mssql+pyodbc://db-dev.my.company.com/devdb?driver=SQL+Server"

根因定位 #

问题本质是Flask-Migrate执行迁移时没有拿到绑定了正确配置的Flask应用上下文，绝大多数情况都是以下三类问题导致的：

• FLASK_APP环境变量配置错误，Flask CLI启动时没有触发create_app()工厂函数加载配置，生成了空配置的默认Flask实例
• 修改migrations/env.py添加Schema识别逻辑时，误改/删除了从当前应用实例读取SQLALCHEMY_DATABASE_URI的代码，导致配置读取失败回退到默认sqlite内存库
• Flask-Migrate初始化逻辑错误，没有在应用工厂内完成和app、db实例的绑定，无法读取到db对应的连接配置

分步修复方案 #

1. 校验FLASK_APP环境变量配置 #

在执行迁移命令的终端确认环境变量指向正确的应用入口，确保Flask CLI能正确触发工厂函数加载配置：

# Linux/macOS 终端
export FLASK_APP=wsgi:app
# Windows PowerShell
$env:FLASK_APP = "wsgi:app"

如果入口文件（比如wsgi.py、app.py）中已经通过app = create_app()生成了实例，上述配置即可；Flask 2.0+版本会自动识别文件内的create_app工厂函数，不需要额外传参。

2. 校验migrations/env.py的配置拉取逻辑 #

打开migrations/env.py，定位到run_migrations_online()函数，确认开头的数据库地址拉取逻辑没有被覆盖，正确代码片段如下：

def run_migrations_online():
    # 以下配置拉取逻辑为核心，修改Schema配置时不要误删
    configuration = config.get_section(config.config_ini_section)
    configuration['sqlalchemy.url'] = current_app.config.get('SQLALCHEMY_DATABASE_URI')
    connectable = engine_from_config(
        configuration,
        prefix='sqlalchemy.',
        poolclass=pool.NullPool,
    )

    with connectable.connect() as connection:
        context.configure(
            connection=connection,
            target_metadata=target_metadata,
            # 你自定义的MSSQL Schema配置可以写在这里，比如include_schemas、version_table_schema等参数
        )
        # 后续迁移逻辑保持默认即可

高频踩坑点：很多人加Schema配置时会不小心删掉configuration['sqlalchemy.url'] = current_app.config.get('SQLALCHEMY_DATABASE_URI')这行，直接导致读不到配置回退到sqlite。

3. 校验Flask-Migrate和应用工厂的绑定逻辑 #

打开app/__init__.py中的create_app()实现，确认Migrate是在工厂内部完成和app、db实例的绑定，正确写法参考：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate

# 注意：db和migrate先在工厂外实例化，不要直接传app参数
db = SQLAlchemy()
migrate = Migrate()

def create_app():
    app = Flask(__name__)
    # 先加载配置
    app.config.from_object('app.local_settings')
    # 再初始化db绑定app
    db.init_app(app)
    # 最后初始化migrate，必须同时传入app和db实例
    migrate.init_app(app, db)

    # 后续蓝图注册、插件初始化逻辑保持不变
    return app

常见错误写法：在工厂外直接执行Migrate(app, db)，或者调用migrate.init_app()时漏传db实例，都会导致迁移时拿不到正确的连接配置。

4. 验证修复 #

如果之前的migrations目录是在配置错误时生成的，可以先删掉整个migrations目录，重新执行命令验证：

flask db init
flask db migrate

执行时控制台不再出现sqlite内存库的相关警告，正常连接MSSQL实例识别表结构生成迁移脚本即为修复成功。

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