Flask中使用sqlalchemy报KeyError: ‘SQLALCHEMY_TRACK_MODIFICATIONS’

最新推荐文章于 2025-06-09 09:21:59 发布
最新推荐文章于 2025-06-09 09:21:59 发布
阅读量870 收藏
点赞数
CC 4.0 BY-SA版权
分类专栏： Web 文章标签： Flask 排错
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/zz962/article/details/79148417
在Flask应用中使用SQLAlchemy时遇到KeyError，问题指向'SQLALCHEMY_TRACK_MODIFICATIONS'。通过复现问题，发现错误源于未正确配置Flask-SQLAlchemy扩展。解决方案可能涉及禁用SQLALCHEMY_TRACK_MODIFICATIONS，参考相关教程进行修复。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

复现
       在flask脚本里使用了sql相关的功能，如

user = User.query.filter_by(username=form.name.data).first()
     结果抛出异常


解决
       目前临时性的解决方案是降低sqlalchemy的版本到2.0，具体做法
       1、使用pip list查看一下当前的sqlalchemy的版本，可见是2.3.2
  
       2、安装指定版本的包
  
最低0.47元/天 解锁文章

200万优质内容无限畅学
SQLALCHEMY_TRACK_MODIFICATIONS警告解决方法
爱唯逸
07-18 2492
SQLALCHEMY_TRACK_MODIFICATIONS警告解决方法
Flask模型迁移出现KeyError: 'migrate'的解决办法
酱橙的博客
04-15 1567
每次模型迁移基本上都会因为一些小问题而使得结果抛出KeyError: 'migrate’这个问题： 产生上述问题原因有以下两种原因： 初始化Migrate对象时没有加db migrate = Migrate(app) 解决方法如下： migrate.init_app(app=app,db=db) 注意：并且使用关键词参数对参数进行赋值，防止赋值错误 manager.py中没有使用c...
flask KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'
suzimuyu99的博客
08-23 3206
今天新搭建了一个框架， 总是遇到KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'这个错误. 查了很多，有的说降低版本pip install Flask-SQLAlchemy==2.1 最终再stackoverflow上查到了解决办法，就是犯了一个很蠢的问题，app = Flask(__name__)出现了两次。。。 如果谁遇到这个问题 1. 可以先查看一下是否一...
Flask-SQLAlchemy 配置详解：从基础到高级应用
最新发布
gitblog_00125的博客
06-09 399
Flask-SQLAlchemy 配置详解：从基础到高级应用 配置概述 Flask-SQLAlchemy 作为 Flask 与 SQLAlchemy 的集成工具，提供了便捷的数据库操作方式。其配置系统设计精巧，允许开发者通过 Flask 应用的 app.config 来管理各种数据库连接参数。所有配置必须在初始化 SQLAlchemy 实例之前完成，配置一旦加载后不会再次读取。 核心配置参数详解 ...
Flask報錯 KeyError 'SQLALCHEMY_TRACK_MODIFICATIONS'.md
Kc12091956的博客
12-03 485
KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS' 关于flask-sqlalchemy中出现的KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'错误 网上资料都是说因为用了2.2/2.3版本的flask-sqlalchemy的缘故 给出的解决方案都是很扯淡的回退了一下版本，回到2.0. 经过研究 发现...
关于 flask中KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'报错
gorrice的博客
05-07 441
这个错误很简单，是因为flask_sqlalchemy的版本太高. pip install flask-sqlalchemy==2.2 // 这样既可
Flask, SQLAlchemy : KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'
fenghan2015的博客
09-12 2338
使用Flask-SQLAlchemy时碰到无法插入数据和查询数据，并报出KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'的错误 原因：由于粗心两个py文件都新建了一个app=Flask(__main__)，所以导致添加数据和查询数据都有问题，model里边的app连接了数据库，而app.py中的app没有设置数据库的连接，所以插入数据和查询数据都会出现异常。 ...
Python2的Flask使用数据库链接，弹出警告SQLALCHEMY_DATABASE_URI、SQLALCHEMY_TRACK_MODIFICATI，配置app.config还有警告
HelloWorld
05-10 4938
弹出以下警告 /home/python/.virtualenvs/Flask_py/local/lib/python2.7/site-packages/flask_sqlalchemy/__init__.py:819: UserWarning: SQLALCHEMY_DATABASE_URI not set. Defaulting to "sqlite:///:memory:". 'SQLA...
在Python程序和Flask框架中使用SQLAlchemy的教程
09-21
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False db = SQLAlchemy(app) ``` 4. **数据库操作**： 使用Flask-SQLAlchemy，我们可以轻松地创建、查询、更新和删除数据库记录。例如，添加新的用户： ```...
第4天：在Flask应用中使用数据库—Flask_SQLAlchemy
猫姐的博客
06-11 835
原文： http://www.catonlinepy.tech/ 声明：原创不易，未经许可，不得转载 1. 你将学会什么 接第3天表单的使用课程，今天的课程主要涉及到与数据库相关的两个插件的使用，一个是Flask_SQLAlchemy，另外一个是Flask_Migrate。通过今天的学习，你将学会如何对数据库进行基本的操作，以及如何完成数据库的迁移。教程中的代码都会托管到github上，猫姐不厌其...
KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'
huanglianggu的专栏
07-28 402
把原来的flask-sqlalchemy 2.3版本卸载了  安装上2.1版本的
关于flask sql 出现KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'
lilovfly的专栏
11-13 1999
查看http://blog.youkuaiyun.com/qq_25730711/article/details/53690687的解决方案
flask-sqlalchemy中出现的 KeyError: ‘SQLALCHEMY_TRACK_MODIFICATIONS‘错误
TardisKey的博客
05-13 2355
转载自https://www.cnblogs.com/String-Lee/p/10061675.html 关于flask-sqlalchemy中出现的 KeyError:'SQLALCHEMY_TRACK_MODIFICATIONS’错误 网上资料都是说因为用了2.2/2.3版本的flask-sqlalchemy的缘故 给出的解决方案都是很扯淡的回退了一下版本，回到2.0.     经过研究 发现原因很显然不是这样子 而是代码从一开始逻辑就不对 研究我们的代码 app/__init_
KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'出错
hotpotbo的博客
07-21 1620
在使用sqlalchemy的时候，出现KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'的错误 说来奇怪，同样的代码如果用脚本启动，就不会用这个问题，用Resful调用的时候就会报上述的错误。   解决方法： 运行pip freeze |grep Flask-SQLAlchemy 看看是不是： Flask-SQLAlchemy>=2.2 如果是...
KeyError: ‘SQLALCHEMY_TRACK_MODIFICATIONS’ 的错误问题
Mr 丶 Tian的博客
06-22 5617
KeyError: ‘SQLALCHEMY_TRACK_MODIFICATIONS’ flask-sqltemplate 的错误问题 - 图片链接和图片上传当出现了这个问题并且，在你的 config 文件中配置了 app.config[‘SQLALCHEMY_TRACK_MODIFICATIONS’] = True但还是报错，这个问题我解决了一下午，从各种地方试图找到答案，但最终无果。 我
KeyError: ‘SQLALCHEMY_TRACK_MODIFICATIONS’ 的错误问题
Akaks的博客
08-26 3356
KeyError: ‘SQLALCHEMY_TRACK_MODIFICATIONS’ 的错误问题  - 图片链接和图片上传 当出现了这个问题并且，在你的 config 文件中配置了  app.config[‘SQLALCHEMY_TRACK_MODIFICATIONS’] = True 但还是报错，这个问题我解决了一下午，从各种地方试图找到答案，但最终无果。  我看了一下我安装的
Flask报如下错误:SQLALCHEMY_TRACK_MODIFICATIONS adds significant overhead and will be disabled by default ...
子钦加油的博客
09-03 963
在同一个项目中由于flask_sqlalchemy版本不同，有时会报如下错误 错误信息如下： flask_sqlalchemy\__init__.py:800: UserWarning: SQLALCHEMY_TRACK_MODIFICATIONS adds significant overhead and will be disabled by default in the f...
关于 flask中KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'
xiadada2的博客
01-12 5269
终于在群里大佬的帮助下解决了  哈哈哈太开心了  解决办法如下 我把原来的flask-sqlalchemy 2.3版本卸载了  安装上2.1版本的  pip install flask-sqlalchemy==2.1
使用flask-alchemy 过程中报错KeyError: 'SQLALCHEMY_TRACK_MODIFICATIONS'
yuanfangderen
10-11 84
在网上找了很多， 大多数说是必须要给SQLALCHEMY_TRACK_MODIFICATIONS 一个默认值，尝试修改alchemy 源码，，但是还是不起作用 最后阅读源码 ， self.app = app = db.get_app() track_modifications = app.config['SQLALCHEMY_TRACK_MODIFICATIONS']源码就是这句报...
from flask import Flask,current_app from flask_sqlalchemy import SQLAlchemy from sentence_transformers import SentenceTransformer, util import app from models.position_model import Position def create_app(): app = Flask(__name__) with app.app_context(): app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://root:root@localhost:3306/talent_matching' app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False # 关闭警告 db = SQLAlchemy(app) db.create_all() current_app.model_bert=SentenceTransformer('./local_models/Sentence-BERT') print("Sentence-BERT模型记载完毕…") return app app=create_app()这是我写的，现在还是报这个错RuntimeError: The current Flask app is not registered with this 'SQLAlchemy' instance. Did you forget to call 'init_app', or did you create multiple 'SQLAlchemy' instances?
03-09
<think>好的，我现在需要帮助用户解决他们遇到的Flask和SQLAlchemy的运行时错误。用户提供的代码中，错误提示是“RuntimeError: The current Flask app is not registered with this 'SQLAlchemy' instance. Did you forget to call 'init_app', or did you create multiple 'SQLAlchemy' instances?”，这说明用户的SQLAlchemy实例和Flask应用实例之间没有正确绑定，或者存在多个实例。 首先，我需要回顾一下之前给出的解决方案。之前建议用户创建一个全局唯一的SQLAlchemy实例，并在应用工厂函数中使用init_app来初始化。用户现在按照这个思路修改了代码，但问题依旧存在，所以需要仔细检查他们的新代码。 看用户的代码，他们定义了一个create_app函数，里面创建了Flask应用实例，并在应用上下文中配置了数据库。这里可能存在几个问题。 第一个问题：用户在create_app函数内部创建了db实例，即db = SQLAlchemy(app)。这会导致每次调用create_app时都创建一个新的SQLAlchemy实例。如果其他模块（如position_model）从其他地方导入db，可能会导入不同的实例，导致多个实例冲突。 第二个问题：用户可能在其他地方（比如models/position_model.py）中再次创建了SQLAlchemy实例，或者没有正确导入全局的db实例。例如，如果在position_model.py中使用了from flask_sqlalchemy import SQLAlchemy并创建了新的db实例，就会导致多个实例存在。 第三个问题：应用上下文的生命周期管理。用户在create_app函数内部使用with app.app_context()，但此时应用尚未完全初始化，可能会导致上下文过早被推出，后续操作不在上下文中，从而引发错误。 接下来，我需要根据这些可能的错误点，给出具体的修改建议。首先，应该将db实例移到create_app函数外部，成为全局唯一的实例。然后在create_app中通过db.init_app(app)来初始化，而不是在函数内部创建新的db实例。此外，需要确保所有模型文件都从同一个全局db实例导入，而不是自己创建新的实例。 另外，用户可能在导入模型时存在循环导入的问题。例如，在app.py中导入了from models.position_model import Position，而position_model.py又导入了app.py中的db。如果app.py在create_app之前导入position_model，可能会导致db尚未初始化，从而导致错误。这需要检查导入顺序，并考虑在create_app中延迟导入模型，或者使用循环导入的解决方案。 最后，用户可能在调用db.create_all()时没有正确的应用上下文，或者db实例尚未正确绑定到应用上。需要确保在调用数据库操作时，应用上下文是活跃的，并且db实例已经正确初始化。 总结来说，用户的主要问题可能在于创建了多个SQLAlchemy实例，并且在模型文件中没有正确导入全局的db实例。此外，可能存在循环导入和应用上下文管理的问题。需要指导用户将db实例全局化，正确初始化，并调整模型文件的导入方式，避免循环依赖。</think>你的代码存在三个关键问题导致报错。以下是逐行修正方案和运行验证流程： --- ### 错误原因解析 1. **多实例问题**：在`create_app()`内部创建`db = SQLAlchemy(app)`，导致每次创建应用都生成新实例 2. **循环导入**：`app.py`导入了`models.position_model`，而模型文件可能又导入了`app.py`的`db` 3. **初始化顺序错误**：在应用工厂内过早调用`db.create_all()` --- ### 修正后的代码实现 #### app.py (主文件) ```python from flask import Flask, current_app from flask_sqlalchemy import SQLAlchemy from sentence_transformers import SentenceTransformer, util # 全局唯一的SQLAlchemy实例 db = SQLAlchemy() def create_app(): app = Flask(__name__) app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://root:root@localhost:3306/talent_matching' app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False # 正确初始化数据库 db.init_app(app) # 加载模型（延迟到应用运行时） with app.app_context(): current_app.model_bert = SentenceTransformer('./local_models/Sentence-BERT') print("Sentence-BERT模型加载完毕…") # 延迟导入模型类避免循环引用 from models.position_model import Position db.create_all() # 必须在db绑定app后调用 return app # 创建应用实例 app = create_app() ``` #### models/position_model.py (模型文件) ```python from app import db # 导入主文件中的全局db实例 class Position(db.Model): __tablename__ = 'positions' id = db.Column(db.Integer, primary_key=True) # 其他字段定义... def to_dict(self): return {c.name: getattr(self, c.name) for c in self.__table__.columns} ``` --- ### 关键修改点说明 #### 修改点1：全局唯一数据库实例 ```diff - db = SQLAlchemy(app) # 错误：在工厂函数内创建实例 + db = SQLAlchemy() # 正确：在全局作用域创建 + db.init_app(app) # 正确：通过init_app绑定 ``` #### 修改点2：解决循环导入 ```python # 在工厂函数内部延迟导入模型 with app.app_context(): from models.position_model import Position # 此时db已初始化 ``` #### 修改点3：正确的模型继承 ```python # 确保所有模型继承自全局db.Model class Position(db.Model): # 使用全局db的Model基类 ``` --- ### 验证流程 1. **启动应用** ```bash flask run ``` 2. **在Python Shell中测试** ```python from app import create_app, db app = create_app() with app.app_context(): positions = Position.query.all() # 应该正常执行 print(db.session) # 输出: <sqlalchemy.orm.scoping.scoped_session object> ``` 3. **检查数据库表** ```sql SHOW TABLES; # 确认positions表已创建 ``` --- ### 常见问题补充 #### 若仍然报错，请检查： 1. **模型文件是否独立创建了db实例** ```python # 错误示例：在模型文件中重复创建 from flask_sqlalchemy import SQLAlchemy db = SQLAlchemy() # 这会产生第二个实例 ``` 2. **路由文件中是否正确使用上下文** ```python @app.route('/') def index(): # 错误：直接调用Position.query.all() # 正确：自动在请求上下文中执行 positions = Position.query.all() return str(len(positions)) ``` 3. **第三方扩展的初始化顺序** ```python # 如果有其他扩展如flask-migrate from flask_migrate import Migrate migrate = Migrate() migrate.init_app(app, db) # 必须在db初始化之后 ``` --- ### 配置流程图解 ``` 应用启动 │ ├─ 创建全局db实例 │ ├─ 调用create_app() │ │ │ ├─ 配置数据库URI │ │ │ ├─ db.init_app(app) │ │ │ └─ 延迟导入模型类 │ └─ 通过app.app_context()执行初始化操作 ``` 通过以上修改，应该可以解决数据库实例绑定问题。如果仍有问题，请提供完整的项目结构截图和错误堆栈信息。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值