flask-sqlalchemy中出现的 KeyError: ‘SQLALCHEMY_TRACK_MODIFICATIONS‘错误

关注

转载最新推荐文章于 2026-10-12 16:40:35 发布 2.4k 阅读 AI 写同款· GEO 优化 ›

Flask生产级API实战：从零搭建可交付REST服务 REST API是现代Web服务的基础通信范式，其核心在于严格遵循HTTP协议规范，实现请求方法、状态码、资源标识与数据序列化的精准协同。Flask作为轻量级WSGI框架，以高度透明的请求生命周期和模块化扩展机制，成为理解API底层原理的理想入口。它不隐藏数据库事务边界、不自动处理JSON异常、不默认启用CORS——这种‘不作为’恰恰迫使开发者直面HTTP从网卡到业务逻辑的17个关键决策点，如路由参数校验、Content-Type防御式解析、数据库唯一约束与软删除设计、标准化错误响应（400/401/403 阅读详情

转载自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__.py

from flask import Flask

app = Flask(__name__)
app.debug = True


from app.home import home as home_blueprint
from app.admin import admin as admin_blueprint

app.register_blueprint(home_blueprint)
app.register_blueprint(admin_blueprint,url_prefix="/admin")

app/models.py

from flask import Flask
from flask_sqlalchemy import SQLAlchemy


app = Flask(__name__)

# 配置数据库
app.config["SQLALCHEMY_DATABASE_URI"] = "mysql+pymysql://root:123456@127.0.0.1:3306/blog"
# 如果设置成 True (默认情况)，Flask-SQLAlchemy 将会追踪对象的修改并且发送信号。
app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False

# 绑定app至SQLAlchemy
db = SQLAlchemy(app)

# 会员模型
class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    ...
    
...

if __name__ == "__main__":

    db.create_all()

在app/init.py 和 app/models.py 中两次分别实例化 Flask 类,生成 app 对象。

而app.config[“SQLALCHEMY_TRACK_MODIFICATIONS”] = False 是在模型文件中设置的。

但是模型中的 app 对象并不是Flask运行时的那个 app 对象

只是用来初始化数据库时临时用到的 app 对象

所以在访问页面的时候会报错 KeyError:'SQLALCHEMY_TRACK_MODIFICATIONS’

应该修改成这样

app/__init__.py

from flask import Flask

app = Flask(__name__)
app.debug = True


from app.home import home as home_blueprint
from app.admin import admin as admin_blueprint

app.register_blueprint(home_blueprint)
app.register_blueprint(admin_blueprint,url_prefix="/admin")

# 配置数据库
app.config["SQLALCHEMY_DATABASE_URI"] = "mysql+pymysql://root:123456@127.0.0.1:3306/blog"
# 如果设置成 True (默认情况)，Flask-SQLAlchemy 将会追踪对象的修改并且发送信号。
app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False

from app.models import db

db.init_app(app)

app/models.py

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()

# 会员模型
class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    ...
    
...

if __name__ == "__main__":

    app = Flask(__name__)
    
    # 配置数据库
    app.config["SQLALCHEMY_DATABASE_URI"] = "mysql+pymysql://root:123456@127.0.0.1:3306/blog"
    # 如果设置成 True (默认情况)，Flask-SQLAlchemy 将会追踪对象的修改并且发送信号。
    app.config["SQLALCHEMY_TRACK_MODIFICATIONS"] = False

    # 绑定app至SQLAlchemy
    db = SQLAlchemy(app)

    db.create_all()