Vercel部署依赖pycairo的Flask应用遇编译错误求解决

AI 小北

2026-8-3

解决方案：Vercel部署Flask应用时预安装pycairo依赖的系统库

问题根源

你当前的package.json中的build脚本未生效，是因为Vercel的@vercel/python构建器不会触发npm的构建命令——这个脚本仅对Node.js相关的构建流程生效。此外，Vercel构建容器默认以root权限运行，无需使用sudo。

具体解决步骤

方法1：直接在`vercel.json`中配置构建命令

修改你的vercel.json，为Python构建器添加buildCommand，在pip安装依赖前执行系统库安装命令：

{
  "builds": [
    {
      "src": "api/app.py",
      "use": "@vercel/python",
      "config": {
        "buildCommand": "apt-get update && apt-get install -y pkg-config libcairo2-dev && pip install -r requirements.txt"
      }
    }
  ],
  "routes": [
    {
      "src": "/(.*)",
      "dest": "api/app.py"
    }
  ]
}

方法2：使用自定义构建脚本（更易维护）

在项目根目录创建build.sh文件，写入以下内容：

#!/bin/bash
# 更新包索引并安装系统依赖
apt-get update && apt-get install -y pkg-config libcairo2-dev
# 安装Python依赖
pip install -r requirements.txt

给脚本添加执行权限（本地执行后提交到仓库）：

chmod +x build.sh

修改vercel.json中的构建配置：

{
  "builds": [
    {
      "src": "api/app.py",
      "use": "@vercel/python",
      "config": {
        "buildCommand": "./build.sh"
      }
    }
  ],
  "routes": [
    {
      "src": "/(.*)",
      "dest": "api/app.py"
    }
  ]
}