Vercel部署Flask应用遇Internal Server Error，求排查方向

数据老陈

2026-7-16

Flask重构后本地正常，Vercel部署后出现Internal Server Error

我近期对Flask应用做了重构，把models、routes、config等模块从单一的app.py拆分出来，本地运行完全正常。但推送到GitHub后，Vercel上Serverless函数构建成功，访问URL时却弹出Internal Server Error。

我不确定问题出在vercel.json的src/dest路径配置错误，还是所用包不被Vercel支持（我用了和Vercel一致的Python版本，理论上不该有问题）。之前按照Vercel官网文档修改vercel.json，不仅没解决问题，反而导致构建失败。

调试步骤建议

优先查看Vercel函数的详细运行日志：进入Vercel控制台的「Functions」选项卡，找到对应函数的运行日志，查看完整的错误栈信息。绝大多数500错误是模块导入失败、依赖缺失或代码逻辑报错导致的，日志会明确指出具体位置。
检查vercel.json的配置正确性：Vercel的Python Serverless函数有固定配置规则，错误配置会导致路由映射失败或函数无法启动。正确的配置示例：
```
{
  "functions": {
    "api/app.py": {
      "runtime": "@vercel/python@3.10"
    }
  },
  "routes": [
    {
      "src": "/(.*)",
      "dest": "/api/app.py"
    }
  ]
}
```
注意：需要将Flask的app实例暴露在api目录下的文件中（比如api/app.py导入主app），或调整配置路径指向正确入口。如果之前修改导致构建失败，先回退到可构建的配置再逐步调整。
排查模块导入路径问题：重构后使用的相对导入（如from .models import XXX）在本地正常，但Vercel执行环境的工作目录可能不同，导致导入失败。解决方法：
1. 在入口文件（如api/app.py）添加路径适配：
```
import sys
from pathlib import Path
# 将项目根目录添加到Python路径
sys.path.append(str(Path(__file__).parent.parent))
```
2. 或把相对导入改为绝对导入（如from myapp.models import XXX），确保项目包名结构正确。
验证依赖安装完整性：检查requirements.txt是否包含所有依赖（包括重构后新增的包）。Vercel会严格按该文件安装依赖，遗漏的包会导致运行时错误。
本地模拟Vercel环境调试：安装Vercel CLI，执行vercel dev命令在本地模拟Vercel运行环境，复现线上错误后再本地调试代码和配置。
临时开启Flask调试模式查看详细错误：在Vercel环境变量中添加FLASK_DEBUG=true，部署后访问页面会显示详细错误信息（注意：调试模式不要在生产环境长期开启）。

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

Vercel部署Flask应用遇Internal Server Error，求排查方向

调试步骤建议 #

调试步骤建议