Dockerfile中使用PNPM安装GitHub依赖时pnpm install报错

使用pnpm作为包管理工具构建Docker镜像时，若项目存在从GitHub拉取的Git来源依赖，pnpm旧版本会默认调用yarn完成该类依赖的prepare阶段安装。基于node:alpine基础镜像构建时触发如下报错，本地环境执行pnpm install则无异常：

ERR_PNPM_PREPARE_PKG_FAILURE  Command failed with exit code 1: /usr/local/bin/yarn install
执行命令'/bin/sh -c pnpm install'时返回非零状态码：1

初始使用的Dockerfile内容：

FROM node:alpine

RUN npm install -g pnpm

WORKDIR /app

COPY ["package.json", "pnpm-lock.yaml", "./"]

RUN pnpm install

COPY . .

RUN pnpm build

ENV PORT=8080

EXPOSE 80

CMD [ "node", "./build/index.js" ]

本次引入的Git来源依赖为Baileys仓库。

• node:alpine为极简裁剪镜像，默认未预装git（拉取GitHub远程源码必需）、yarn（pnpm旧版本处理Git依赖的默认调用工具），直接触发执行失败，并非权限问题。
• pnpm默认配置会拦截依赖的install后脚本执行，Git来源拉取的Baileys需要执行prepare脚本完成自身构建，拦截后会触发安装流程异常。
• 原Dockerfile存在配置不匹配问题：环境变量定义服务端口为8080，但EXPOSE声明的暴露端口为80，会导致容器启动后端口映射异常。

提供两种可直接复用的修复方案，按需选择即可：

方案1：兼容旧版本pnpm #

补全镜像内缺失的Git、yarn依赖，放开pnpm的脚本执行限制，修改后Dockerfile如下：

FROM node:alpine

# 安装基础依赖，如需加速包下载可自行配置npm镜像源
RUN apk add --no-cache git yarn \
    && npm install -g pnpm

WORKDIR /app

COPY ["package.json", "pnpm-lock.yaml", "./"]

# 放开脚本执行限制，执行依赖安装
RUN pnpm config set ignore-scripts false && pnpm install

COPY . .

RUN pnpm build

ENV PORT=8080
# 修正端口匹配问题
EXPOSE 8080

CMD [ "node", "./build/index.js" ]

方案2：使用新版pnpm，移除yarn依赖 #

pnpm 8.x及以上版本已重构Git依赖处理逻辑，无需调用yarn即可完成Git依赖的prepare阶段执行，仅需安装Git即可，镜像体积更小，修改后Dockerfile如下：

FROM node:alpine

# 仅安装Git依赖，无需部署yarn，如需加速包下载可自行配置npm镜像源
RUN apk add --no-cache git \
    && npm install -g pnpm@latest

WORKDIR /app

COPY ["package.json", "pnpm-lock.yaml", "./"]

# 锁定依赖版本安装，放开脚本执行权限
RUN pnpm config set ignore-scripts false && pnpm install --frozen-lockfile

COPY . .

RUN pnpm build

ENV PORT=8080
EXPOSE 8080
CMD [ "node", "./build/index.js" ]

• 如果安装过程中触发原生模块编译报错（比如sharp、node-gyp相关错误），需要在apk add命令中追加编译工具链依赖：python3 make g++
• 构建阶段不要随意切换非root用户执行pnpm install，否则会出现缓存目录、node_modules目录的读写权限问题，默认root用户执行构建无权限风险。

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