You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Nuxt现代应用构建进度停在95%无法完成的问题咨询

问题现象截图

Nuxt构建进度卡在95%无法终止的常见原因
  • Webpack优化阶段死锁:Nuxt2默认基于Webpack4构建,进度到95%时通常处于代码压缩环节,由TerserPlugin处理JS压缩、OptimizeCSSAssetsPlugin处理CSS压缩。当项目代码体积大、依赖引用复杂时,偶发压缩进程死锁,或单进程内存不足以完成压缩任务,导致进程无响应挂起。
  • 静态页面预渲染阻塞:如果使用nuxt generate模式构建静态站点,95%阶段对应页面预渲染流程。如果页面的asyncData/fetch逻辑中存在未捕获异常的异步请求、接口无响应、异步逻辑死循环,会导致渲染进程卡在单个页面,既不会继续执行也不会抛出错误终止。
  • 依赖版本兼容冲突:项目中如果存在多个版本的压缩工具依赖冲突,比如重复安装不同版本的terser、css-minimizer-webpack-plugin,或是Node.js版本与Nuxt依赖的Webpack版本不匹配,也会偶发构建进程无响应的问题。
  • 活跃句柄未释放:如果自定义了Nuxt构建插件,或是在全局逻辑中启动了数据库连接、WebSocket连接等常驻实例,且未在构建完成钩子中手动销毁,会导致Node.js事件循环始终存在活跃任务,进程无法正常退出。
排查&修复方案
  • 优先增大Node.js构建内存上限,将构建命令修改为 node --max-old-space-size=8192 node_modules/nuxt/bin/nuxt.js build,排除内存不足导致的挂起问题。
  • 开启构建debug日志,执行 nuxt build --debug 查看卡在95%时的具体执行任务,快速定位阻塞节点。
  • 静态生成场景下,给所有页面的asyncData/fetch异步逻辑增加超时控制和异常捕获,避免无响应请求阻塞整个构建流程。
  • 排查压缩工具依赖版本冲突,可临时关闭生产环境代码压缩验证是否是压缩环节导致的问题,确认后升级对应依赖到兼容版本即可。

内容的提问来源于stack exchange,提问作者Čamo

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.27 15:45:07