部署Flask应用至Vercel时Werkzeug依赖报错求助

问题分析 #

报错ENOENT: no such file or directory, lstat '/vercel/path0/werkzeug/__pycache__/_compat.cpython-39.pyc'的核心原因是：本地缓存文件版本与Vercel构建环境不匹配、依赖文件位置配置混乱，以及项目结构不符合Vercel Python运行时的预期。

解决方案 #

1. 清理本地缓存并排除缓存文件

• 在项目根目录创建或更新.gitignore文件，添加以下规则：

  __pycache__/
  *.pyc
  *.pyo
  *.pyd
  

• 提交修改到仓库，避免本地生成的Python缓存文件被推送到远程，彻底消除缓存版本冲突的可能。

2. 规范项目文件结构

当前app.py放在api/static目录下不符合Flask项目常规结构，建议调整为：

root
 - api
    - app.py
    - static/
    - templates/
       - index.html
    - requirements.txt
    - vercel.json
 - .gitignore

将Pipfile和Pipfile.lock移回api目录（或直接删除，改用requirements.txt统一管理依赖），Vercel Python运行时默认从函数所在目录读取依赖配置，这样能保证依赖安装路径与运行路径一致。

3. 修正vercel.json配置

确保配置文件正确指向Flask入口，并指定匹配的Python版本：

{
  "functions": {
    "api/app.py": {
      "runtime": "@vercel/python@3.9"
    }
  },
  "routes": [
    {
      "src": "/(.*)",
      "dest": "/api/app.py"
    }
  ]
}

此配置会将所有请求转发到api/app.py处理，同时指定Python 3.9运行时，与报错中的cpython-39版本完全匹配。

4. 强制清除Vercel构建缓存

• 使用Vercel CLI重新部署时添加--force参数：

  vercel deploy --force
  

• 或登录Vercel控制台，进入项目的「Settings」→「Build & Development Settings」，点击「Clear Build Cache」后重新触发构建。

5. 统一依赖管理

如果选择使用requirements.txt，确保文件中包含明确的依赖版本：

Flask==2.3.3
Werkzeug==2.3.7

避免版本兼容问题，同时删除Pipfile和Pipfile.lock，防止Vercel构建时混淆依赖源。

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