为何Docker在MacOS执行npm i失败，Windows却运行正常？

问题根源 #

Windows上Docker默认使用x86_64架构镜像，bcrypt有对应预编译包，安装流程顺畅；但Mac（尤其是M系列arm64芯片）下Docker默认拉取arm64架构镜像，bcrypt暂未提供linux-arm64-musl预编译包，触发源码编译时，容器基础镜像缺少Python、编译工具等依赖，导致node-gyp配置失败，最终npm安装报错。

解决方案 #

方案1：在Dockerfile中添加编译依赖（通用推荐）

根据你使用的基础镜像类型，在RUN npm i步骤前安装编译所需工具：

• 若基于Alpine镜像：

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

• 若基于Debian/Ubuntu镜像：

RUN apt-get update && apt-get install -y python3 make gcc g++ && rm -rf /var/lib/apt/lists/*
RUN npm i

方案2：指定Docker构建平台为linux/amd64

强制Docker使用x86_64架构镜像，匹配bcrypt已有的预编译包：

• 在docker-compose.yml的服务配置中添加platform字段：

services:
  your-service:
    build: .
    platform: linux/amd64
    # 保留原有其他配置

• 或者构建时直接指定平台：

docker-compose build --platform linux/amd64
docker-compose up

方案3：替换为纯JS实现的bcryptjs

如果对性能要求不高，可改用无需编译的bcryptjs，其API与bcrypt基本兼容：

1. 替换依赖：

npm uninstall bcrypt
npm install bcryptjs

2. 代码中替换导入：

// 原代码
const bcrypt = require('bcrypt');
// 改为
const bcrypt = require('bcryptjs');

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