部署FastAPI应用到Vercel时出现Python运行时版本不匹配问题

• 问题原因
  Vercel的Serverless Functions不会自动同步你本地的Python版本，它默认使用的Python 3.6已被AWS停止支持，因此部署时触发版本无效报错。

• 解决步骤

  1. 在项目根目录创建vercel.json文件，手动指定兼容的Python runtime版本：

     {
       "functions": {
         "api/**/*.py": {
           "runtime": "@vercel/python@3.11"
         }
       }
     }
     

     注：如果你的FastAPI入口文件不在api目录下（比如根目录的main.py），请将路径改为对应文件路径，例如"main.py"。

  2. 检查项目依赖配置文件（requirements.txt或pyproject.toml），确保没有限制Python版本低于3.9的规则，避免构建时版本冲突。

  3. 清理Vercel缓存并重新部署：

     vercel build --clean
     vercel deploy
     

• 验证方法
  部署完成后，在Vercel控制台的函数详情页，查看Runtime字段是否显示你指定的版本（如Python 3.11）。

内容的提问来源于stack exchange，提问作者Lee Skies