升级Flask-SQLAlchemy至3.0.2后出现KeyError: WeakRef问题求助

直接解决步骤 #

1. 确保数据库操作处于应用上下文内 #

虽然路由函数默认会自动激活应用上下文，但如果你的场景中自动激活失效，显式激活上下文即可解决：

@application.route("/injury")
def get_injury_by_id():
    with application.app_context():
        return db.session.query(Injury).filter_by(id=1).first()

或者改用Flask-SQLAlchemy 3.x推荐的模型查询写法（更简洁且上下文绑定更可靠）：

@application.route("/injury")
def get_injury_by_id():
    return Injury.query.filter_by(id=1).first()

2. 检查应用与DB的绑定逻辑 #

• 确保db.init_app(application)只执行一次，避免重复初始化导致应用实例与DB引擎的映射关系混乱。
• 排查是否存在多个Flask应用实例，确保当前运行的实例是db绑定的那个。

错误原因解析 #

从栈追踪能看到，错误发生在Flask-SQLAlchemy尝试获取对应应用的数据库引擎时，找不到绑定的应用实例弱引用。这是因为：

• 3.x版本对应用上下文与DB引擎的绑定做了重构，使用弱引用字典存储映射关系。如果应用实例的引用被意外回收，或者操作DB时上下文未正确绑定到db对应的实例，就会触发这个KeyError。
• 你测试代码中用with application.app_context()显式激活上下文能正常运行，也验证了问题根源是上下文绑定失效。

额外排查要点 #

• 确认Injury模型继承自db.Model，且模型定义/导入在db.init_app(application)之后。
• 若使用蓝图，确保蓝图注册在db.init_app之后，蓝图视图能正确获取上下文。
• 升级Flask到2.0+版本，确保与Flask-SQLAlchemy 3.x的兼容性。

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