Docker容器中执行npm install时Sharp模块安装失败如何解决？

该错误本质为Alpine系统采用musl libc作为标准库，sharp默认预编译的libvips依赖针对glibc环境构建，二者ABI不兼容导致符号查找失败。可根据实际场景选择以下方案修复：

• 方案1：Alpine镜像内预安装编译依赖
  修改Dockerfile，在执行npm install前安装sharp所需的系统依赖，也可强制从源码编译sharp避免预编译包兼容问题：

FROM node:12.13.0-alpine AS alpine
WORKDIR /api
# 安装sharp编译运行依赖
RUN apk add --no-cache build-base gcc g++ make vips-dev libc6-compat
COPY package.json .
RUN npm install --build-from-source sharp

如果是多阶段构建，最终运行镜像也需要保留vips-dev或vips-libs依赖，否则运行时仍会报错。

• 方案2：切换为glibc环境的Node镜像
  直接替换基础镜像为基于Debian的slim版本，和本地开发环境标准库一致，无需额外调整依赖即可正常安装：

FROM node:12.13.0-slim
WORKDIR /api
COPY package.json .
RUN npm install

该方案镜像体积略大于Alpine版本，但兼容性最好，无需处理依赖适配问题。

• 方案3：校验sharp版本兼容性
  你使用的Node 12.13.0最高支持sharp@0.29.x版本，若package.json中sharp版本高于0.29.3，也会出现安装异常，可锁定sharp版本为兼容范围后重新安装。

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