在Vercel部署Django应用时遇pip安装错误求助

错误原因 #

你本地找不到setup.cfg，但这个文件大概率来自requirements.txt里某个依赖包的内部配置。Vercel使用Python3.9环境，对应的setuptools版本可能比你本地的更严格，会检测依赖包中过时的setup.cfg配置，直接导致构建wheel失败。

解决步骤 #

1. 锁定依赖版本并更新requirements.txt #

本地运行命令，生成和本地环境完全一致的依赖版本清单，避免Vercel拉取兼容性存疑的最新依赖：

pip freeze > requirements.txt

2. 指定兼容的setuptools版本 #

在requirements.txt最上方添加一行，锁定一个对废弃配置检测更宽松的稳定版本：

setuptools==65.5.1

3. 配置Vercel运行环境 #

在项目根目录新建vercel.json文件，明确Python运行时和路由规则（替换your_project_name为实际项目名）：

{
  "builds": [
    {
      "src": "your_project_name/wsgi.py",
      "use": "@vercel/python"
    }
  ],
  "routes": [
    {
      "src": "/(.*)",
      "dest": "your_project_name/wsgi.py"
    }
  ]
}

4. 清缓存重新部署 #

在Vercel控制台的项目「Deployments」页面，找到最新部署记录，点击「Redeploy」并勾选「Clear build cache」，强制重新拉取所有依赖构建。

额外排查点 #

• 若以上步骤无效，逐个移除requirements.txt中最近添加的依赖，重新部署定位问题包；
• 确保本地Python版本也是3.9，和Vercel运行环境保持一致。

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