调用Pydantic.BaseModel.model_dump()报AttributeError及版本不一致问题

数据老陈

2026-7-9

问题分析与解决办法

核心问题是Pydantic版本不一致：你本地终端显示的是2.4.2，但FastAPI运行时实际加载的是1.10.2。model_dump()是Pydantic 2.x才新增的方法，1.x版本里对应的方法是dict()，这就导致了矛盾——VS Code基于本地2.x的类型提示显示model_dump()可用，但实际运行时用的是1.x，调用就报错；反过来用dict()时，VS Code又会提示你改用2.x的方法。

解决步骤：

第一步：确认运行环境的Pydantic版本
在你的FastAPI代码里添加两行代码，启动服务后看输出：
```
import sys
import pydantic
print("Python路径:", sys.executable)
print("运行时Pydantic版本:", pydantic.__version__)
```
拿到输出的Python路径后，在终端执行：
```
/刚才输出的Python路径 -m pip show pydantic
```
这时候应该会显示版本是1.10.2，坐实环境不一致的问题。
第二步：升级对应环境的Pydantic
用同样的Python路径执行升级命令：
```
/刚才输出的Python路径 -m pip install --upgrade pydantic==2.4.2
```
（也可以直接装最新版，把==2.4.2换成--upgrade pydantic）
第三步：验证修复
重启FastAPI服务，再看pydantic.__version__的输出，确认已经是2.x版本。这时候再调用model_dump()就不会报错，VS Code的提示也能和实际运行行为一致了。
额外注意
如果你的项目用requirements.txt管理依赖，记得把里面的Pydantic版本改成pydantic>=2.0，避免后续重新安装时又自动装回1.x版本。