SQLAlchemy merge_all 级联时提前 flush，完整对象却报非空约束失败

session.merge(child) 能成功，换成 session.merge_all([child]) 却在调用内部报 NOT NULL constraint failed: child.parent_id。如果子对象带着已脱离旧 Session 的父对象，而级联合并需要查询父记录，应检查失败 SQL 是否插入了尚未合并完整的状态。

SQLAlchemy 2.1.6 的 merge_all() 会在需要加载时先做一次常规 autoflush，但它随后批量调用内部合并流程时，没有像单个 merge() 那样包住 no_autoflush。级联途中触发的延迟加载可能再次刷新，把属性尚未协调完成的新对象送到数据库。

先限定合并阶段，再正常提交

对于已经确认属于这条路径的代码，可局部保护批量合并，让属性与关系先协调完成：

with session.no_autoflush:
    merged = session.merge_all(incoming_objects)

session.flush()

这里使用应用已有的 Session 与待合并对象。输入仍须通过业务完整性与权限检查；no_autoflush 只延迟由查询触发的自动刷新，不会补造缺失外键，也不会跳过块外显式 flush() 的数据库约束。

若当前会话本来就有其他合法待写入内容，应先按事务设计决定何时刷新。不要把整个请求永久设置为 autoflush=False，让所有依赖已写入数据的查询都改变行为。正常写入成功后，仍按原事务边界提交；失败时沿用既有回滚流程，再决定重试或结束请求。

对照单个 merge，避免混入集合替换问题

比较两种调用时，保持映射、输入对象状态和数据库数据相同，检查失败发生在合并内部的关系加载，还是最终显式刷新。后者如果仍然缺必填值，就是实际数据或映射问题，不能继续用关闭刷新来隐藏。

另外，merge 对已经提供的关系集合有自己的协调语义。只传部分子项而造成旧成员解除关联，可参照部分集合合并后旧外键变 NULL；那不是本次批量入口的刷新时机回归，no_autoflush 不会把整体替换变成追加。

2.1.7 的开发发行说明已列出这项调整，但当前记录没有正式发行日期，不能据此让项目安装一个尚未正式发布的修补。后续采用正式版本时，保留原来失败的级联场景，并确认只写入完整对象、约束仍有效、实际业务事务没有被提前拆开。