Docker构建Strapi应用时npm install卡在npm info ok求助

问题场景 #

在Ubuntu 22.04服务器上使用Docker构建Strapi应用时，构建流程卡在npm info ok处无法自动退出，本地Ubuntu 24.04非Docker环境下应用安装运行正常。相关Dockerfile和构建输出如下：

原Dockerfile #

FROM node:18.17.1-alpine as build
ENV NODE_ENV=production
WORKDIR /opt/
COPY ./package.json ./package-lock.json ./
ENV PATH /opt/node_modules/.bin:$PATH
RUN npm install -g npm@10.9.2
RUN npm i --omit=dev --verbose
WORKDIR /opt/app
COPY ./ .
RUN npm run build

FROM node:18.17.1-alpine
ENV NODE_ENV=production
WORKDIR /opt/
COPY --from=build /opt/node_modules ./node_modules
ENV PATH /opt/node_modules/.bin:$PATH
WORKDIR /opt/app
COPY --from=build /opt/app ./
EXPOSE 1337
CMD ["npm", "run","start"]

构建输出片段 #

added 1679 packages, and audited 1681 packages in 13m

npm verbose cwd /opt
npm verbose os Linux 5.15.0-46-generic
npm verbose node v18.17.1
npm verbose npm  v10.9.2
npm verbose exit 0
npm info ok

核心原因分析 #

1. npm与Node.js版本不兼容：Node.js 18.17.1官方适配的npm版本为9.x，强制全局升级到npm 10.9.2（适配Node.js 20+）会导致构建过程出现隐性阻塞。
2. 工作目录路径分离：构建阶段将node_modules放在/opt，项目代码放在/opt/app，路径分离可能导致npm在后续步骤中无法正确识别依赖上下文。
3. Alpine镜像环境的权限/输出阻塞：Alpine镜像默认使用node用户，部分依赖安装可能存在权限问题；npm的verbose输出或进度条也可能在容器环境中导致进程挂起。

解决方案 #

1. 修正Node.js与npm版本匹配问题 #

移除全局升级npm的步骤，使用Node.js 18自带的npm版本，同时统一工作目录到/opt/app，避免路径分离：

修改后的Dockerfile：

FROM node:18.17.1-alpine as build
ENV NODE_ENV=production
WORKDIR /opt/app
# 先复制依赖文件，利用Docker缓存
COPY ./package.json ./package-lock.json ./
RUN npm i --omit=dev --verbose
# 复制项目代码
COPY ./ .
RUN npm run build

FROM node:18.17.1-alpine
ENV NODE_ENV=production
WORKDIR /opt/app
# 复制构建好的依赖和代码
COPY --from=build /opt/app/node_modules ./node_modules
COPY --from=build /opt/app ./
EXPOSE 1337
CMD ["npm", "run", "start"]

2. 禁用npm进度条与冗余输出 #

在npm命令中添加--no-progress参数，避免容器环境中输出阻塞：

# 替换build阶段的npm install命令
RUN npm i --omit=dev --verbose --no-progress
# 替换build命令
RUN npm run build --no-progress

3. 添加.dockerignore减少冗余复制 #

创建.dockerignore文件，避免本地无关文件被复制到镜像，干扰构建：

node_modules
.git
.env
.env.local
build
dist
.cache

4. 解决权限问题 #

若仍存在阻塞，可在安装依赖时添加--unsafe-perm参数，跳过权限检查：

RUN npm i --omit=dev --verbose --unsafe-perm

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