Flask数据库迁移报错：检测到create_app工厂但无法无参调用

问题原因 #

报错提示Detected factory 'create_app' in module 'app', but could not call it without arguments，是因为Flask CLI自动检测到app模块里的create_app工厂函数，但该函数需要传入config_name参数才能运行。而flask run能正常启动，是因为你的manage.py已经提前用正确的参数实例化了app，且CLI环境可能指向了manage.py，但Flask-Migrate的命令默认直接去app模块找工厂函数，没传入必要参数。

解决方案 #

方案一：指定FLASK_APP为manage.py #

直接让Flask CLI使用manage.py中已经实例化好的app，不需要再调用工厂函数。在终端执行以下命令设置环境变量：

# Linux/macOS
export FLASK_APP=manage.py
# Windows 命令提示符
set FLASK_APP=manage.py
# Windows PowerShell
$env:FLASK_APP = "manage.py"

设置完成后，再执行迁移命令：

flask db migrate -m 'initial Migration'

方案二：修改create_app函数支持无参调用 #

调整app/__init__.py里的create_app函数，给参数设置默认值，让它可以无参运行：

def create_app(config_name=None):
    # 如果没传参数，自动读取环境变量或用默认配置
    if config_name is None:
        config_name = os.getenv('FLASKCONFIG') or 'default'
    app = Flask(__name__)
    app.config.from_object(config[config_name])
    config[config_name].init_app(app)
    
    bootstrap.init_app(app)
    mail.init_app(app)
    login_manager.init_app(app)
    db.init_app(app)
    jwt.init_app(app)
    migrate.init_app(app,db)
    
    from app.main import main as main_blueprint
    from app.auth import auth as authentication_blueprint
    app.register_blueprint(main_blueprint)
    app.register_blueprint(authentication_blueprint, url_prefix='/auth')
    return app 

修改后，直接执行迁移命令即可，Flask CLI会自动调用无参的create_app()创建实例。

方案三：直接指定工厂函数的参数 #

按照错误提示的方式，在设置FLASK_APP时传入create_app需要的参数：

# Linux/macOS
export FLASK_APP="app:create_app('default')"
# Windows 命令提示符
set FLASK_APP=app:create_app('default')
# Windows PowerShell
$env:FLASK_APP = "app:create_app('default')"

这里的'default'可以替换成你实际需要的配置名称，之后再执行迁移命令即可。

内容的提问来源于stack exchange，提问作者Martins. Adesua