Angular10升级至11后启动报错：Class was missing valueDeclaration

问题原因 #

这个错误属于TypeScript类型检查器的内部异常，通常由以下情况引发：

• Angular与TypeScript版本不兼容（Angular 11要求TypeScript 4.0.x版本，升级后TS版本未同步会触发该问题）
• 第三方依赖库未适配Angular 11，导致依赖冲突
• 项目缓存或依赖安装不完整，残留旧版本编译文件
• 项目代码中存在不规范的类/接口定义（比如未正确导出类、接口声明语法错误等）

解决步骤 #

1. 对齐TypeScript版本 #

打开package.json，将typescript依赖修改为Angular 11兼容的版本：

"typescript": "~4.0.7"

执行命令更新依赖：

npm install

2. 彻底清理缓存与依赖 #

• 删除项目根目录下的node_modules文件夹、package-lock.json（或yarn.lock）文件
• 清理npm缓存：

  npm cache clean --force
  

• 重新安装依赖：

  npm install
  

• 清理Angular CLI缓存：

  ng cache clean
  

3. 检查并升级第三方依赖 #

查看package.json中的第三方库（比如rxjs、@angular/material、各类组件库），确保它们支持Angular 11：

• rxjs需对应~6.6.0版本
• 第三方UI库需升级到适配Angular 11的版本
  找到不兼容的库后，执行对应升级命令，比如：

ng update @angular/material@11

4. 排查代码中的类型定义问题 #

逐步排查项目代码，重点检查：

• 是否存在未正确导出的类或接口
• 是否有重复声明的类型
• 是否使用了过时的装饰器或类型语法
  可以通过注释部分模块代码，重新运行ng serve定位触发错误的文件，修复对应问题。

5. 强制更新Angular CLI配置 #

如果是CLI配置文件损坏导致的问题，执行强制更新命令：

ng update @angular/cli@11 --force

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