构建多平台Docker镜像失败，疑因bcrypt与ARM64兼容问题

问题背景 #

在GitHub Actions中配置platforms: linux/amd64,linux/arm64构建多平台Docker镜像时，npm install阶段因bcrypt依赖的node-pre-gyp执行失败退出（错误码1）。单平台构建可正常运行，Dockerfile基于node:16.15.1-alpine，包含npm依赖安装、Prisma客户端生成等步骤。

解决方案 #

1. 补充Alpine编译依赖 #

Alpine镜像默认缺少编译bcrypt所需的构建工具，在执行npm install前安装必要依赖：

• 在Dockerfile的builder阶段，npm install命令前添加：

  RUN apk add --no-cache python3 make g++
  

2. 替换为纯JS版bcrypt #

使用无需编译的bcryptjs替代原生bcrypt，彻底避免跨平台编译问题：

1. 卸载原依赖：npm uninstall bcrypt
2. 安装替代包：npm install bcryptjs
3. 代码中替换导入：将require('bcrypt')改为require('bcryptjs')，API与原包基本兼容

3. 强制从源码编译或指定预编译包 #

通过npm参数强制从源码构建，或配置环境变量获取对应平台的预编译二进制包：

• 修改npm install命令为：

  RUN npm install --build-from-source
  

• 若需要拉取GitHub上的预编译包，可添加GitHub Token环境变量（需在Actions中配置对应secret）：

  RUN NODE_PRE_GYP_GITHUB_TOKEN=${{ secrets.GITHUB_TOKEN }} npm install
  

4. 优化Buildx构建配置 #

在GitHub Actions的docker/build-push-action中添加缓存和镜像拉取配置，提升多平台构建稳定性：

- name: Build and push Docker image
  uses: docker/build-push-action@ad44023a93711e3deb337508980b4b5e9bcdc5dc
  with:
    context: .
    push: true
    tags: user/docker-image:latest
    platforms: linux/amd64,linux/arm64
    cache-from: type=gha
    cache-to: type=gha,mode=max
    pull: true

修改后的Dockerfile示例（方案1） #

FROM node:16.15.1-alpine as builder

WORKDIR /app

COPY package*.json ./

# 安装编译依赖
RUN apk add --no-cache python3 make g++

RUN npm install

COPY . .

RUN npx prisma generate

EXPOSE 4500

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

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