截至 2026 年 11 月 17 日,sqlalchemy 官网的版本状态表把 2.1 列为当前发布系列,2.0 则归入维护系列。两条分支同日更新:11 月 16 日,官网分别公布了 2.1.9 和 2.0.58。对于仍在维护旧服务的团队,同日收到两个分支的补丁,与决定何时跨分支迁移,是两件不同的事。

来源:SQLAlchemy 官网页面
下载页对维护模式的说明是按实际需要提供关键修复,并建议仍在积极开发的应用开始迁移到当前系列。维护不等于停止支持,也不是对所有新能力都会回移的承诺。官网把 1.4 单独标作结束支持,不能把这个状态套到 2.0 上。
同一天推出的两个补丁,也不是内容完全一致的重复发布。2.0.58 的公告说明其中一批修复从 2.1 系列回移,涉及关系加载和编译缓存。2.1.9 公告则另列了该分支的数据类和关联子查询回归。遇到具体故障,应按部署中的版本找对应条目,不能只看两个公告是否同一天发布。
打算跨到 2.1 的团队,要核对的不止是框架版本。项目的迁移文档列明,2.1 的 Python 兼容起点是 3.11;异步扩展需要的 greenlet 不再随基础安装默认装入,而放在 asyncio 扩展依赖中。仍在较旧解释器上运行的服务,无法只替换框架包就完成迁移。

智谱AI开放平台
智谱AI开放平台是一款提供 GLM 系列大模型 API、微调、推理和评测能力的一站式 MaaS 平台。
下载
来源:SQLAlchemy 官方文档
同一份迁移记录还列出了 PostgreSQL 默认驱动的变化:连接地址未指定驱动时,2.1 默认尝试 psycopg 第三版;明确指定 psycopg2 的入口仍受支持。即使业务查询没有改动,使用默认连接地址的部署也可能加载不同驱动。这一变化不能和数据库服务器版本的升级混为一谈。
官网把同一系列内的补丁更新和跨分支迁移分开说明,并建议在升级时使用测试套件或预发布环境。前一种选择可以保留现有应用的分支约束;后一种需要同时核对解释器、异步依赖和连接配置。官网当前没有在维护说明中给出 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.