Vercel部署serverless函数使用canvas时ZLIB_1.2.9缺失如何解决

开发者阿泽

2026-9-30

问题核心

Vercel Serverless 运行环境基于 Amazon Linux 2，其官方 yum 源内置的 zlib 最高版本仅为 1.2.7，无法满足新版 node-canvas 依赖的 libpng 对 ZLIB_1.2.9 版本的要求，因此直接通过 yum 安装无法拿到更高版本的zlib。

解决方案

方案1：更换无系统依赖的canvas实现（优先推荐）

直接替换原版node-canvas为@napi-rs/canvas即可，该库基于Rust开发，预先编译了适配所有主流Serverless环境的二进制包，无需任何系统依赖，API和原版node-canvas完全兼容，几乎不用修改业务代码：

卸载原版canvas：npm uninstall canvas
安装替代包：npm install @napi-rs/canvas
业务代码中把所有require('canvas')替换为require('@napi-rs/canvas')，原有绘图逻辑不需要做任何调整

方案2：手动编译安装zlib 1.2.9（保留原版canvas）

如果必须使用原版node-canvas，可以修改package.json中的vercel-build脚本，手动下载zlib源码编译后替换canvas依赖目录下的库文件：

"scripts": {
  "vercel-build": "yum install -y libuuid-devel libmount-devel gcc make && \
    wget https://zlib.net/zlib-1.2.9.tar.gz && \
    tar xzf zlib-1.2.9.tar.gz && \
    cd zlib-1.2.9 && \
    ./configure --prefix=/tmp/zlib && \
    make && make install && \
    cd .. && \
    cp /tmp/zlib/lib/libz.so.1 node_modules/canvas/build/Release/ && \
    cp /lib64/{libuuid,libmount,libblkid}.so.1 node_modules/canvas/build/Release/"
}