SQLAlchemy更新关联列表时忽略None值问题求助

问题原因 #

当通过创建新的Child实例并赋值给parent.children更新关联列表时，SQLAlchemy会执行merge操作将新实例与数据库中已存在的记录合并。默认配置下，merge操作会忽略None值——它将None视为未初始化的默认值，而非主动设置字段为NULL的操作，因此不会把该字段纳入UPDATE语句。而插入新记录时不存在合并逻辑，None值能正常写入NULL。

解决方案 #

方案一：直接修改已存在的数据库对象 #

最直接的方式是先查询数据库中已有的Child记录，直接修改其属性，而非创建新实例替换：

parent = Parent.query.get(xxx)
# 假设更新数据为字典列表
update_data = [{"a": 123, "b": "b", "c": None}, ...]

for data in update_data:
    child = Child.query.get(data["a"])
    if child:
        # 直接修改已有对象属性
        child.b = data["b"]
        child.c = data["c"]
    else:
        # 不存在则创建新对象并关联
        parent.children.append(Child(**data))

db.session.flush()

方案二：手动merge时强制包含NULL值 #

若倾向于用创建新实例的方式更新，可在merge操作时指定include_nulls=True，强制将None值纳入UPDATE语句：

parent = Parent.query.get(xxx)
new_children = []
update_data = [{"a": 123, "b": "b", "c": None}, ...]

for data in update_data:
    child = Child(**data)
    # 手动执行merge，指定include_nulls=True
    merged_child = db.session.merge(child, include_nulls=True)
    new_children.append(merged_child)

parent.children = new_children
db.session.flush()

方案三：强制更新单个对象（适用于单条记录） #

针对单条已存在的Child记录更新，可使用force_update=True强制生成包含所有字段的UPDATE语句：

child = Child.query.get(123)
child.b = "b"
child.c = None
db.session.flush(child, force_update=True)

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