第一次运行查询正常,可一旦命中编译缓存,部分 orm 加载选项就可能失效。sqlalchemy 11 月 16 日发布的2.0.58 维护版回移了针对这一类问题的修复,涉及多态子类加载、别名实体上的子查询加载,也涉及继承对象预加载、父子关系删除时的异常行为。

来源:SQLAlchemy 官方博客
在 2.0.58 更新日志记录的一类故障中,外层关系指向别名实体,子类关系的加载选项被放在 selectin_polymorphic() 下面。如果之前执行并缓存了另一条结构不同、但使用相同加载选项的上层语句,这些内嵌选项可能被静默跳过。修复后的多态加载会从缓存语句使用对应选项,而不是把这类选项漏掉。
另一处出现在针对别名实体的 subqueryload()。在函数里重建查询时,也可能生成新的 aliased() 或 with_polymorphic() 对象。旧版在复用已编译语句的情况下,可能只在第一次执行时应用内嵌的列选择或关系加载选项;新版让子查询加载按缓存语句中的对应选项处理。

来源:SQLAlchemy 官方文档
两种缺陷的共同点是首次执行未必能复现。编译缓存存的是语句编译后的产物,不是查询结果。对受影响应用来说,更有辨识度的回归用例要覆盖缓存命中,并比较加载到的字段与关系;只看是否返回了行,未必能发现加载范围被改变。
这次回移的修复不只涉及读取。父对象删除的修复针对配置了 post_update 的一对多关系:过去可能先在普通更新中清空相关对象外键,又在后置更新里清空一次。日志说明现在只发出后置更新,并明确让它排在删除父行之前。它解决的是特定关系配置下的重复语句与执行顺序,不是所有删除操作的行为变更。
针对 PostgreSQL,更新日志还单独列出了 TSQUERY 和 REGCONFIG 的表结构反射修复。旧行为可能在读取已有表结构时把这些列识别为未知类型并发出警告,现在会识别到方言中对应的类型。仍在 2.0 维护线的项目可分别核对加载、删除与表结构反射;这批回移并不表示 2.1 的全部功能同时进入了 2.0。
截图许可: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.