Docker构建Vue项目时npm run build完成后进程挂起无法退出

看起来你的问题是Docker构建到npm run build这一步时，明明日志已经显示构建完成了，但整个进程却挂着不往下执行后续步骤对吧？我帮你梳理下大概率的原因和对应的解决办法：

首先看你的package.json里的build脚本：

"build": "vue-cli-service build && npm run test:unit"

这里vue-cli-service build确实已经完成了（日志里的DONE Build complete就是证明），但后面跟着的npm run test:unit很可能是导致进程挂起的罪魁祸首——因为单元测试框架（这里是jest）在某些非交互式环境下（比如Docker的RUN命令执行环境），可能会默认进入watch模式，或者因为测试用例里有未处理的异步任务，导致进程无法正常退出。

给你几个具体的排查和解决步骤：

1. 先定位问题根源 #

临时修改package.json里的build脚本，暂时去掉单元测试部分：

"build": "vue-cli-service build"

然后重新执行Docker构建。如果这次构建能顺利完成，那百分百是test:unit命令的问题，接下来针对性处理即可。

2. 强制单元测试退出watch模式 #

Docker的RUN命令是在无TTY的环境下执行的，jest如果检测不到终端，可能会出现异常行为。你可以给test:unit命令明确加上禁用watch的参数：
修改package.json里的test脚本：

"test:unit": "vue-cli-service test:unit --no-cache --watchAll=false"

或者在执行build时通过环境变量强制CI模式（CI环境下jest会自动禁用watch）：

"build": "vue-cli-service build && CI=true npm run test:unit"

3. 检查测试用例是否有未清理的异步任务 #

如果加了上面的参数还是挂起，那就要检查你的单元测试代码了：

• 有没有未mock的异步请求（比如axios调用），导致jest等待请求完成；
• 有没有未清理的定时器（比如setTimeout、setInterval），可以用jest.clearAllTimers()在测试结束后清理；
• 有没有开启了watch相关的jest插件或配置，比如jest.config.js里的watch: true或者watchPlugins配置，这些在Docker环境下必须禁用。

4. 拆分Docker构建命令（便于排查） #

你也可以把Dockerfile里的RUN npm run build --verbose拆成两步，这样能更清晰看到哪一步出问题：

RUN npm run build --verbose
RUN npm run test:unit --verbose

如果是第二步挂起，就更能确定是单元测试的问题。

按照上面的步骤排查下来，基本能解决进程挂起的问题。

备注：内容来源于stack exchange，提问作者Berlin Brown