树莓派5B安装canvas npm依赖失败问题求助

问题分析 #

从错误日志来看，核心问题有两点：

• canvas@2.11.2没有适配Node.js 18（ABI v108）的arm64预编译二进制包，请求GitHub对应资源返回404
• 切换官方镜像后出现GitHub连接超时，无法获取预编译包，且源码编译缺少必要系统依赖，导致编译执行失败

解决方案 #

方案1：升级canvas到兼容当前环境的版本 #

canvas v2.12.0及以上版本已适配Node.js 18的arm64架构，直接安装最新稳定版即可：

npm install canvas@latest

如果项目需要指定版本，可选择官方明确标注支持Node.js 18 + arm64的版本。

方案2：安装系统编译依赖，强制源码编译 #

若必须使用旧版本canvas，先安装树莓派OS上的编译依赖库：

sudo apt update && sudo apt install -y libcairo2-dev libjpeg-dev libpango1.0-dev libgif-dev build-essential pkg-config

依赖安装完成后重新执行canvas安装命令：

npm install canvas

临时解决GitHub连接超时 #

如果是网络问题导致无法获取预编译包，可临时设置npm代理（根据自身网络环境调整）：

npm config set proxy http://你的代理地址:端口
npm config set https-proxy https://你的代理地址:端口

安装完成后取消代理：

npm config delete proxy
npm config delete https-proxy

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