项目里 langchain 停在 0.1.20,Pydantic 1.10.15,跑了半年没事。上周想用新的 create_react_agent,升到 0.3.7,pip 第一步就失败,报 Cannot install langchain 0.3.7 and fastapi 0.95.2,依赖冲突。
看依赖树才明白,langchain 0.3 依赖 langchain-core 0.3,langchain-core 0.3 要求 pydantic 2.5.2 以上,而 fastapi 0.95.2 锁的是 pydantic 1.x。两个包在同一环境里没法共存。
试过 pip install --no-deps langchain==0.3.7,装上了,import 直接报 PydanticUserError: A non-annotated attribute was detected,内部 Agent 模型还是 pydantic 1 的写法,v2 不认。
也试过 pydantic.v1 兼容层,把 Tool 参数模型改成 from pydantic.v1 import BaseModel。自己那部分过了,LangChain 内置的工具还是 v2 模型,传到 AgentExecutor 里又炸。
最后把 fastapi 升到 0.115.0,pydantic 2.9.2,langchain 0.3.7,langchain-core 0.3.15,langchain-openai 0.2.8,写进 constraints.txt 用 -c 装。
锁版本之后还要跑一遍冒烟脚本,import 所有用到的类,再构造一个只返回固定字符串的假模型跑一次 Agent,确认 tool 能调到。光看 pip 成功不算数,运行时才会暴露 pydantic 的模型不兼容。
预发环境用同一份 constraints 重建镜像,Python 3.10.13,跑了两天没再出现导入错误。以后再升大版本,先看 langchain-core 的 pydantic 下限,比看 langchain 的 changelog 省事。
# constraints.txt
pydantic==2.9.2
langchain==0.3.7
langchain-core==0.3.15
langchain-openai==0.2.8
fastapi==0.115.0
# 安装
pip install -c constraints.txt -r requirements.txt 