从Angular 9升级到10后执行ng serve启动报未处理Promise拒绝警告

对应问题场景 #

• 项目从 Angular 9 版本迁移升级到 Angular 10 版本，PrimeNG 等所有第三方依赖均已同步升级到适配 Angular 10 的对应版本
• 项目常规生产构建、单元测试执行流程全程无报错
• 执行启动命令 ng serve -o 时，控制台抛出未捕获 Promise 拒绝错误，核心报错栈显示为 Error: spawn UNKNOWN，错误触发在子进程创建阶段

常见诱因与排查操作 #

• 检查全局与本地 Angular CLI 版本匹配度
  Angular 10 对CLI版本匹配要求严格，若全局安装的 @angular/cli 仍为9.x大版本，和本地项目依赖的10.x CLI不匹配时，Windows环境启动阶段会触发子进程拉起失败，直接抛出spawn UNKNOWN。可直接执行ng version同时查看全局、本地CLI版本，若存在大版本差异，先卸载全局旧版CLI，再安装与本地项目依赖完全一致的10.x版本CLI重试。
• 排查浏览器自动唤起逻辑
  命令中的-o参数作用是服务启动完成后自动唤起系统默认浏览器，若当前执行环境（无图形界面的远程服务器、权限受限的终端账号）没有权限拉起浏览器进程，或是升级过程中angular.json内serve节点的浏览器打开配置残留旧版本无效字段，都会触发该报错。可先移除-o参数执行ng serve，如果服务能正常启动，再单独修正自动打开浏览器的配置、检查终端对系统浏览器路径的访问权限即可。
• 清理残留依赖缓存后重装
  版本升级过程中如果未完全删除旧的node_modules目录，会存在版本混杂的残留文件。这类残留往往不影响构建、单测流程，但会导致serve阶段webpack-dev-server依赖的子进程模块文件损坏，触发创建失败。操作时先删除项目根目录的node_modules文件夹，执行npm cache clean --force清理本地npm缓存，再重新安装全部依赖后重试启动。
• 校验Node.js版本兼容性
  Angular 10 仅支持Node.js 10.14版本到14.15版本区间的运行环境，若当前使用的Node.js版本超出该兼容区间，会在子进程系统调用阶段触发未知错误。通过node -v查看当前版本，匹配对应兼容版本后再重试启动命令。

内容的提问来源于stack exchange，提问作者Melvin Kah Hoo