Angular Universal构建卡在10%无报错，求解决方案

问题场景 #

维护多年前的Angular Universal（SSR）遗留项目，新增功能后构建时卡在「10% building modules 1/1 modules 0 active」无报错；已尝试升降级Node/Angular CLI、重装依赖、外部执行构建命令均无效。禁用AOT可完成构建，但生成的server.js存在大量装饰器报错无法运行；调整依赖版本后构建可突破卡点，但在94%时出现@types相关语法错误。

可行解决方案 #

1. 严格锁定依赖与Node版本 #

• 找到项目最初稳定运行时的Node版本，用nvm固定环境：

  nvm install [对应版本号]
  nvm use [对应版本号]
  

• 核对package.json中Angular生态依赖版本（@angular/core、@angular/cli、@angular/universal等），确保大版本完全一致，避免跨版本混合依赖
• 执行npm ci替代npm install，严格按照package-lock.json安装依赖，杜绝版本漂移问题

2. 排查Webpack配置与AOT编译冲突 #

• 检查webpack.server.config.js，暂时移除自定义的loader、plugin（如压缩、代码分析类插件），简化配置后重新构建，排查是否有插件干扰AOT流程
• 打开angular.json，确认projects.appName.architect.server下的AOT配置为"aot": true，且无冲突的自定义参数

3. 修复@types相关语法错误 #

• 定位报错的@types包，查看其版本与项目TypeScript版本的兼容性：比如TS 4.2版本需搭配@types/node@14.x系列，过高的@types版本会触发语法不兼容问题
• 手动调整对应@types包的版本到兼容范围，例如：

  npm install @types/node@14.17.0 --save-dev
  

• 检查项目自定义.d.ts类型声明文件，排查是否存在语法错误或与第三方类型冲突的情况

4. 彻底清理构建缓存 #

• 执行Angular CLI缓存清理：

  ng clean
  

• 手动删除dist、.angular/cache、node_modules/.cache/webpack（若存在）目录，再重新执行构建命令

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