sqlalchemy 2.1.9 修复了两个可能影响实际读写结果的回归问题。项目在11 月 16 日的发布公告中说明,一处会让带特定默认对象的 orm 映射数据类无法完成刷写,另一处会让部分关联查询生成的 lateral 子查询失去与外层查询的关联。前者在发出写入时暴露;后者可能不报错,却返回不正确的行。

来源:SQLAlchemy 官方博客
数据类写入的问题并不影响每一种映射字段。官方更新日志列出的触发对象是 orm_insert_sentinel(),以及放在 mapped_column() 默认值位置的 ColumnDefault 或 Sequence 对象。旧逻辑可能把默认对象本身当作插入参数传给数据库,而它们原本是列定义用的对象,并不是应用想存进这一列的普通值。
修复后,这类对象只作用于列定义,不再充当 Python 一侧的属性默认值。日志注明,属性在刷写前仍为 None。这里说的刷写,是会话把待写入的变更发送到数据库,不等于提交事务。回归检查既要看插入是否成功,也要区分刷写前读取属性与数据库实际生成列值这两个时点。
读取侧的问题发生在关系指向一个使用相关 LATERAL 子查询的别名类时。此类子查询需要引用外层当前行;如果关联丢失,生成的语句仍可能执行,却不再根据对应的外层记录筛选。更新日志指出,带 DISTINCT 或 GROUP BY 的 joinedload() 查询被包进子查询时,现在会连同预加载连接一起改写有关的关联元素。

智谱AI开放平台
智谱AI开放平台是一款提供 GLM 系列大模型 API、微调、推理和评测能力的一站式 MaaS 平台。
下载
来源:SQLAlchemy 官方文档
这一版也补上了其他加载方式的同类修复,包括 selectinload()、subqueryload() 和惰性加载等路径。这并不意味着所有使用这些加载器的查询此前都有问题;官方描述的共同条件仍是那种依赖外层行的 LATERAL 关系。适合回归的样本,是外层多行本来应各自得到不同关联结果的查询。
引擎还有一项与两个回归问题无关的改动:启用 Cython 扩展时,普通及异步结果的 mappings() 把逐行映射转换移入编译扩展,减少每行的 Python 层开销。公告未给出适用于全部应用的提速比例。数据类写入修复、关联查询正确性和映射结果转换性能,需要按各自触发条件判断。
截图许可:SQLAlchemy MIT License。截图为官方页面的局部截取、等比缩放及补白,图床可能添加站点水印。
Copyright 2005-2026 SQLAlchemy authors and contributors . Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.