Angular12迁移报错NG6002：AppSharedModule出现在AppModule的imports中但自身存在错误

报错场景：Angular 12 + PrimeNG 12 版本迁移后，执行ng build触发Appears in the NgModule.imports of AppModule, but itself has errors报错，已尝试运行ng serve、禁用Ivy等方案无效

排查步骤 #

• 清除全量缓存与依赖，解决版本兼容残留问题，依次执行以下命令：

# 删除旧依赖、缓存文件
rm -rf node_modules package-lock.json .angular
# 重装依赖
npm install

执行完成后重新运行ng build，此时通常会输出AppSharedModule内部的具体报错信息，而非仅提示模块存在错误。

• 校验AppSharedModule本身的配置合法性
  • 确认所有导入的PrimeNG组件均为12.x版本，PrimeNG大版本必须与Angular大版本严格对齐，禁止混装更高版本的组件包
  • 检查模块内导入的Angular API是否符合12版本规范，移除旧版本废弃的API导入、过时的组件语法
  • 核对模块的declarations、imports、exports数组中没有重复声明、路径错误的依赖项
• 修正Ivy配置
  Angular 12默认强制启用Ivy编译，PrimeNG 12完全适配Ivy规范，手动禁用Ivy会触发兼容报错，需要删除tsconfig配置中enableIvy: false的相关配置。
• 开启编译详细日志定位根因
  运行ng build --verbose输出完整编译日志，向上回溯NG6002报错的前置日志，即可定位到AppSharedModule内具体触发错误的代码位置。

注：同位置的大量重复报错为根因错误触发的连锁报错，修复根因后所有关联报错会同步消失

内容的提问来源于stack exchange，提问作者Rômulo Sorato