Vue生产构建在Docker中执行npm run build时卡住

从你的构建日志能看到，npm run build已经输出构建完成的提示，但Docker的RUN步骤就是不往下推进，核心原因是build进程没有正常退出，大概率是版本冲突或CLI运行模式导致的，给你几个针对性解决办法：

1. 解决Vue CLI版本冲突问题 #

你的项目依赖里用的是@vue/cli-service ~5.0.0，但Docker里全局安装了旧版本@vue/cli@3.7.0，版本不匹配会导致CLI进程异常，甚至无法正常退出。直接删掉全局安装的步骤就行——项目本地已经通过npm install装了对应版本的cli-service，完全不需要全局安装旧版本。

2. 强制CLI在CI模式下运行 #

Vue CLI在非CI环境下可能会残留后台进程（比如隐性的文件监听），导致build完成后不退出。在build命令前加上CI=true环境变量，强制CLI以一次性任务模式运行，确保构建完成后立即终止进程。

3. 优化后的Dockerfile #

把你的Dockerfile改成下面这样：

# build environment
FROM node:lts-alpine as build
WORKDIR /app
# 优先复制package文件，利用Docker缓存减少重复安装
COPY package*.json ./
RUN npm install --silent
# 复制项目源码
COPY . .
# 用CI模式执行build，确保进程正常退出
RUN CI=true npm run build

# production environment
FROM nginx:stable-alpine
COPY --from=build /app/dist /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

额外排查建议 #

如果修改后还是卡住，先在本地项目目录运行npm run build，看命令执行完后是否自动回到终端：

• 如果本地也卡住，说明是项目配置问题（比如某个插件异常），可以尝试临时禁用eslint或其他插件排查；
• 如果本地正常，那就是Docker环境下的进程退出问题，确认CI=true是否生效，或者尝试用node node_modules/@vue/cli-service/bin/vue-cli-service.js build直接调用本地cli-service执行构建。

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