事务提交后数据未更新,大概率是上下文错误、缓存干扰、隔离级别屏蔽或建表失败所致;commit()仅写数据不建表,需确保db.create_all()在app_context中正确执行且模型已注册。

事务提交后数据没更新,大概率不是“没提交”,而是你根本没在正确的上下文里提交,或者提交了但立刻被后续操作覆盖、回滚或隔离级别屏蔽了。
db.session.commit() 被调用但数据库文件/表无变化
这通常意味着 db.create_all() 根本没跑成功,或者表压根没建出来——commit() 只写数据,不建表。常见原因:
-
db.create_all()调用时不在app.app_context()中,导致模型未加载,建表逻辑跳过 - SQLite 路径是相对路径,实际生成位置在
os.getcwd()目录下,而不是你认为的项目根目录(比如你在上级目录运行python app.py) - 模型类定义在
db = SQLAlchemy()实例之后才导入,导致db.create_all()看不到它们(典型循环导入或初始化顺序错误)
验证方法:加一行调试输出 print([t.name for t in db.metadata.tables.values()]),如果为空,说明模型没注册进当前 db 实例。
数据已提交但 SELECT 查不到最新值
这是最易被误判为“没更新”的情况,本质是事务隔离或缓存问题:
- 你在同一个
db.session中先commit(),又立刻用User.query.get(id)查询——SQLAlchemy 默认从 session 缓存返回旧对象,不会重新查库(identity map 行为) - 你在另一个线程/请求中查询,但数据库隔离级别是
READ COMMITTED或更低,而目标事务还没结束(比如还在长事务中),新数据不可见 - 你用了
with_for_update()但没配session.expire_on_commit = False,导致 commit 后对象自动过期,下次访问触发重查——但若没显式refresh()或新建 session,可能仍读缓存
临时绕过:查询前加 db.session.expunge_all() 清空本地缓存,或改用 db.session.execute(text("SELECT ...")).fetchone() 绕过 ORM 缓存。
commit() 执行了但数据被悄悄回滚或覆盖
看似提交成功,实则被后续逻辑抵消:
- 你调用了
db.session.commit(),但之后又调用了db.session.rollback()(比如在 finally 块里无条件 rollback) - 你用的是 Flask 的
SQLALCHEMY_COMMIT_ON_TEARDOWN=True(已弃用但仍有项目残留),它会在请求结束时自动 commit,而你的手动 commit 可能早于某些变更,导致“提交了旧状态” - 多个并发请求同时修改同一行,且没加锁(如漏掉
with_for_update()),后提交者覆盖前提交者的值(丢失更新)
检查点:在 commit() 后立刻加日志 print("committed user.id=", user.id, "money=", user.money),再查数据库确认该行是否真变了——别只信 Python 对象的属性值。
为什么 with_for_update() 加锁后数据还是没按预期更新?
行锁本身生效了,但你更新的不是锁住的那条记录,或者锁没拿到就执行了 update:
-
with_for_update()必须和query绑定,且该 query 必须真正命中数据库(不能是 session 缓存里的对象)。常见错误:先User.query.get(id)拿到对象,再对它调with_for_update()—— 这个调用无效,因为对象已存在,没发 SQL - 你执行了带锁查询,但没在同一个 session 中做后续 update;或者锁查询和 update 之间发生了
commit(),导致锁释放 - MySQL 默认引擎是 MyISAM(不支持事务和行锁),或 PostgreSQL 在
READ COMMITTED下SELECT ... FOR UPDATE不阻塞其他事务的 UPDATE(需升到REPEATABLE READ)
正确姿势:锁查询和修改必须在同一次 session 生命周期内,且中间不能 commit。示例:user = User.query.with_for_update().get(user_id); user.balance -= 1; db.session.commit()。
最常被忽略的一点:Flask-SQLAlchemy 的 session 是 per-request 绑定的,但如果你在后台线程、定时任务或单元测试里操作数据库,必须手动创建并管理 app.app_context() 和 db.session,否则所有 commit() 都像往空气里扔石头——无声无息,也不报错。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











