修改数据库模型后Flask应用启动及迁移报错求助

核心错误原因 #

错误RuntimeError: A 'SQLAlchemy' instance has already been registered on this Flask app.的本质是同一个Flask应用上注册了两个SQLAlchemy实例：你自己在databases.py中定义的db实例，加上Flask-Session在配置SESSION_TYPE = 'sqlalchemy'时，默认会自动创建新的SQLAlchemy实例，两者冲突引发报错。

同时代码还有几处语法/逻辑错误，会影响应用正常运行，一并修正。

分步修复方案 #

1. 让Flask-Session复用已有SQLAlchemy实例 #

在create_app()函数中新增配置，指定Flask-Session使用你定义的db实例，避免重复创建：

def create_app():
    app = Flask(__name__)

    # 设置数据库地址
    app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///notes.db'

    # 配置用户会话
    app.config['SESSION_TYPE'] = 'sqlalchemy'
    app.config['SESSION_PERMANENT'] = False
    # 添加该行：指定复用已有的db实例
    app.config['SESSION_SQLALCHEMY'] = db
    user_session.init_app(app)
    
    # ... 其余代码

2. 修正会话操作的错误写法 #

你混淆了Flask-Session的扩展实例user_session与Flask原生会话对象session：操作会话数据必须用从flask导入的session，user_session仅用于初始化扩展。

修改login和profile路由中的会话代码：

# login路由内
else:
    # 将user_session['email']改为session['email']
    session['email'] = email_input if checkbox else None
    return redirect(url_for('profile', id=user_record.id))

# profile路由内
if session.get('email'):

3. 修复数据库会话调用错误 #

代码中db.session()是错误写法，db.session本身就是会话实例，无需加括号调用。修正两处查询代码：

# login路由内的查询
user_record = db.session.execute(
    db.select(User).filter_by(email=email_input)
).scalar_one_or_none()

# profile路由内的查询
user_record = db.session.execute(
    db.select(User).filter_by(id=id)
).scalar_one_or_none()

4. 规范迁移初始化位置（可选） #

将migrate = Migrate(app, db)移至db.init_app(app)之后，确保Migrate使用已绑定到应用的db实例：

from databases import db, User

db.init_app(app)
# 移至此处初始化迁移
migrate = Migrate(app, db)

with app.app_context():
    db.create_all()

修正后的迁移执行步骤 #

1. 若之前初始化过迁移，删除项目根目录下的migrations文件夹
2. 执行命令：flask db init
3. 执行命令：flask db migrate -m "Set email field unique"
4. 执行命令：flask db upgrade
5. 启动应用：flask --debug run

内容的提问来源于stack exchange，提问作者Ong K.S