Flask-SQLAlchemy执行commit后未保存数据库变更的问题

一、为什么数据库没更新？ #

你遇到的这个问题，核心原因是SQLAlchemy没有检测到Customer对象的变更，所以没有生成对应的UPDATE语句，自然commit后数据库没变化。具体到你的场景，主要和JSON字段的特性有关：

SQLAlchemy默认对可变类型（比如Python字典）的变更感知比较弱——哪怕你直接替换了contextjason的整个字典值，有时候也不会触发SQLAlchemy的变更检测机制，导致它认为这个对象没有修改，也就不会生成UPDATE语句。

另外先提个小细节：你的模型里定义的字段是clientid，但查询时用的是Customer.custid == custid，如果这不是笔误（比如模型里实际应该是custid），那可能查询逻辑存在问题？不过你说print(custObj.contextjason)能正常输出，应该是字段名的笔误，建议先确认模型字段和查询条件的一致性。

二、解决数据库不更新的方案 #

针对JSON字段的变更检测问题，给你几个可行的解决办法：

1. 显式标记对象为脏数据
   在修改字段后，手动告诉SQLAlchemy这个对象需要被更新，比如：

   custObj.contextjason = { 'foo':'bar', 'so':'be it'}
   db.session.add(custObj)  # 显式添加到会话，标记为需要更新
   db.session.commit()
   

   或者更直接地标记为脏：

   db.session.dirty.add(custObj)
   

2. 创建新的字典对象赋值
   因为SQLAlchemy能检测到对象引用的变化，你可以基于原字典创建一个新的字典再赋值，比如：

   # 基于原字典更新，生成新的字典对象
   new_context = custObj.contextjason.copy()
   new_context.update({'foo':'bar', 'so':'be it'})
   custObj.contextjason = new_context
   db.session.commit()
   

   这样因为赋值的是新的字典对象，SQLAlchemy能感知到变化，自动生成UPDATE语句。

3. 使用MutableDict追踪内部变化
   如果需要支持修改字典内部的键值对也能被检测到，可以使用SQLAlchemy的MutableDict类型：
   首先在models.py里导入并修改字段定义：

   from project import db
   from sqlalchemy.dialects.postgresql import JSON
   from sqlalchemy.ext.mutable import MutableDict
   
   class Customer(db.Model):
       id = db.Column(db.Integer, primary_key=True, autoincrement=True)
       clientid = db.Column(db.String(64))
       # 改成MutableDict包裹JSON类型
       contextjason = db.Column(MutableDict.as_mutable(JSON))
   

   这样之后，不管是替换整个字典，还是修改字典里的某个键值对（比如custObj.contextjason['foo'] = 'bar'），SQLAlchemy都能检测到变化，自动生成UPDATE语句。

三、如何输出详细的SQL执行日志？ #

你开启SQLALCHEMY_ECHO=True后只看到COMMIT，是因为没有生成UPDATE语句。当解决了变更检测问题后，SQLALCHEMY_ECHO=True应该就能输出UPDATE的SQL日志了。

如果需要更详细的日志（比如包含绑定的参数值），可以通过Python的logging模块配置：

import logging
logging.basicConfig()
logging.getLogger('sqlalchemy.engine').setLevel(logging.INFO)

这样就能看到完整的SQL执行流程，包括连接、执行的SQL语句、参数、提交等所有细节。

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