如何修复FastAPI中使用Pydantic model.dict()方法的弃用警告？

核心原因 #

Pydantic v2 对API做了重大调整，原.dict()方法被标记为弃用，官方推荐使用.model_dump()替代（功能完全一致），.json()则替换为.model_dump_json()。

排查与解决步骤 #

• 替换代码中的旧API：
  把代码里所有的your_model.dict()替换为your_model.model_dump()，如果用到.json()就换成.model_dump_json()。示例：

  # 旧写法
  user_data = user_model.dict(exclude_unset=True)
  # 新写法
  user_data = user_model.model_dump(exclude_unset=True)
  

• 确保项目依赖的Pydantic已升级到v2+：
  若使用虚拟环境，先激活项目对应的虚拟环境（比如source venv/bin/activate或venv\Scripts\activate），再执行升级命令：

  pip install --upgrade pydantic
  

  可通过pip show pydantic查看当前项目环境的Pydantic版本，确认是2.x以上。

• 切换VSCode的Python解释器到项目环境：
  点击VSCode右下角的Python版本号，在弹出列表中选择项目虚拟环境对应的解释器（通常路径为项目下的venv/bin/python或venv\Scripts\python.exe），确保编辑器使用的是已升级Pydantic的环境。

验证 #

修改代码并确认环境后，按Ctrl+Shift+P输入Python: Restart Language Server重启VSCode的Python语言服务，弃用警告即可消失。

内容的提问来源于stack exchange，提问作者Ansar Ktk