Docker多阶段构建Node镜像运行node-prune时docker build报错

• 运行阶段未显式指定工作目录：第二阶段node:10-alpine没有配置WORKDIR，COPY指令使用相对路径时，会默认把文件拷贝到容器根目录/下，导致依赖、代码文件路径完全不符合Node.js项目的运行预期。
• 跨基础镜像的二进制兼容问题：构建阶段使用基于Debian的node:10镜像（依赖glibc库），运行阶段使用Alpine镜像（依赖musl libc库），如果项目存在包含C++原生扩展的npm依赖，构建阶段编译出的二进制文件无法在Alpine环境下加载执行。
• 运行阶段缺失必要文件：仅拷贝了node_modules和dist目录，没有拷贝package.json，执行npm脚本时会直接报找不到package.json的错误。
• 启动命令配置错误：构建阶段已经执行npm prune --production删除了所有开发依赖，而npm run start:dev通常依赖nodemon、ts-node这类开发依赖启动开发服务，依赖缺失必然启动失败；且开发启动命令本身也不适合生产镜像使用。

按照以下逻辑调整Dockerfile即可解决问题：

• 构建阶段统一使用Alpine版本的Node镜像，和运行阶段系统库版本对齐，避免原生模块兼容问题，安装node-prune前先补全Alpine缺失的curl、bash依赖。
• 两个阶段都显式声明WORKDIR /app，所有路径操作都基于该工作目录执行，避免相对路径错位。
• 运行阶段额外拷贝package.json文件，满足npm执行脚本的基础要求。
• 替换启动命令为生产环境启动命令，直接通过node执行构建后的dist目录入口文件，不需要依赖开发态工具。

修正后的Dockerfile内容如下：

# 构建阶段：和运行阶段同用alpine基础镜像，保证二进制兼容
FROM node:10-alpine as builder
# 安装node-prune所需的curl、bash依赖
RUN apk add --no-cache curl bash
RUN curl -sfL https://install.goreleaser.com/github.com/tj/node-prune.sh | bash -s -- -b /usr/local/bin
WORKDIR /app
COPY package.json ./
# 先装全量依赖用于构建
RUN npm install
COPY . .
RUN npm run build
# 裁剪冗余依赖：只保留生产依赖，再用node-prune删除多余文件
RUN npm prune --production
RUN /usr/local/bin/node-prune

# 运行阶段
FROM node:10-alpine
WORKDIR /app
# 拷贝生产依赖、构建产物、package.json
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/package.json ./package.json
EXPOSE 3000
# 替换为生产启动命令，直接执行构建后的js文件，路径根据项目实际入口调整
CMD ["node", "dist/main.js"]

如果项目package.json里已经配置了生产启动脚本（比如start:prod），也可以把CMD替换为npm run start:prod，但直接执行node命令启动的性能比npm脚本启动更好，也能避免信号传递异常问题。

内容的提问来源于stack exchange，提问作者Đoàn Đức Bảo