LangChain Python 1.5.0：最低要求升至 Python 3.11，新增模型路由中间件

LangChain Python 1.5.0 将最低运行版本升至Python 3.11，并要求langchain-core至少1.8.0，同时加入模型路由与自动模式中间件。Python 3.10项目仍会解析到1.4.x，升级时需同时检查运行镜像、依赖锁和测试环境。

公告时间：2026年11月11日 23:47:22（北京时间）。

来源：官方发布说明。

LangChain 1.5.0 的兼容性变化

LangChain Python 1.5.0 已于2026年11月11日23:47:22（北京时间）发布。官方明确移除 Python 3.10 支持，最低版本改为 Python 3.11，langchain-core 的最低版本提高到1.8.0。对于仅更新包、不更新解释器的项目，这是本版最需要先处理的兼容性条件。

Python 3.10 项目为什么没有装到1.5.0

发布说明指出，Python 3.10 用户会继续解析到 langchain 1.4.x。依赖管理器选择兼容的旧版本不必然是镜像缓存或下载失败。判断时应检查当前虚拟环境使用的解释器、锁文件及安装约束，而不是删除所有缓存反复重装。旧分支是否满足项目安全要求，还需要另外跟踪该分支公告。

依据：官方发布记录

升级应覆盖开发、CI与部署环境

建议先盘点本地开发、CI执行器、容器基础镜像以及生产运行环境的 Python 版本。在测试分支把解释器统一到至少3.11，再按项目原有的包管理器更新锁文件，并确认 langchain-core 不低于1.8.0。只在个人电脑升级解释器而保留旧部署镜像，会造成“本地可安装、部署失败”的差异。

模型路由与自动模式中间件

1.5.0 加入 model router 和 auto mode middleware；其中 ModelRouterMiddleware 被明确标为 beta。对准备使用新路由能力的项目，应先核对官方示例与决策模型配置，再比较已有固定模型链路的行为。beta标记意味着接口和行为仍应在测试环境验证，不能把它当成无需配置即可自动降低费用或提高准确率的保证。

如何验证依赖升级没有改变业务输出

验证可分为安装和行为两层：先确认解释器、langchain及langchain-core实际版本，再使用已有输入样本检查模型调用、工具执行和结果结构。涉及新中间件时，应额外记录每次运行最终选择的模型及被阻止的工具行为，方便判断差异来自路由配置还是依赖升级。本文未运行真实模型调用，不提供虚构效果或成本数据。

升级与暂留旧版本如何取舍

当前不能迁移 Python 的项目可暂时维持兼容的1.4.x依赖锁，并单独规划解释器升级。需要1.5.0新中间件的项目则应把运行环境迁移作为同一变更处理。两种方案都应保留可回退的镜像和锁文件，不要以手工绕过包元数据的方式强装不受支持组合。

依据：官方发布记录

常见问题

Python 3.10 还能安装LangChain吗？

仍可解析到兼容的1.4.x，但不满足1.5.0的运行条件。

ModelRouterMiddleware 已经稳定了吗？

本次发布将它明确标为beta，应先验证再使用。