Node Canvas部署Vercel Serverless Function遇大小超限问题求助

canvas官方包的体积过大是因为内置了完整的预编译Skia图形库二进制文件，无法通过裁剪依赖或按需导入核心模块来缩小体积——它的API设计是整体绑定的，拆分后无法正常运行。以下是可行的替代方案：

一、替换为轻量canvas实现 #

优先推荐体积更小、适配Serverless环境的替代库：

• @napi-rs/canvas：基于Rust编译的canvas兼容库，压缩后体积仅10-15MB左右，API和官方canvas几乎完全一致，无需大幅修改现有代码，且对Vercel Serverless/Edge环境支持良好。
• sharp：如果你的图片生成需求仅涉及基础操作（如文字叠加、图片拼接、格式转换），sharp的体积更小（压缩后约5MB），性能也更优，虽然API和canvas不同，但能覆盖多数常见场景。

二、优化Vercel打包配置 #

• 启用Next.js的依赖外部化：在next.config.js中添加experimental.serverComponentsExternalPackages: ['canvas']，让Vercel尝试使用系统预安装的依赖（注：Vercel环境默认未预装canvas，此方法仅当使用兼容的第三方预编译包时有效）。
• 清理冗余依赖：构建前执行npm prune --production，确保仅打包生产依赖，但此操作对canvas本身的体积无影响，仅能清理其他冗余开发依赖。

三、切换到Vercel Edge Functions #

Edge Functions的压缩包体积限制为150MB，远高于Serverless Functions的50MB上限。如果使用@napi-rs/canvas这类支持Edge环境的库，可将API路由改为Edge函数（在路由文件顶部添加export const runtime = 'edge'），直接绕过体积限制。

四、拆分API路由隔离依赖 #

将使用canvas的API路由单独拆分，避免其大体积影响其他API函数的部署。但此方法无法解决单个函数的体积超限问题，仅适用于多API路由的项目。

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