Angular12应用引用Angular10构建的库出现编译错误如何解决

错误根因 #

该报错属于Angular大版本跨级引用第三方库的常见问题：所有带有ɵɵ前缀的API均为Angular框架内部私有API，不会对外提供跨版本兼容性承诺。Angular 10构建的库生成的类型定义中引用了当时版本的这三个内部API，而Angular 12已经将对应内部API移除或重命名，因此TypeScript在编译阶段找不到对应定义，抛出错误。

可用解决方案 #

• POC快速验证方案：在项目根目录的tsconfig.json文件中，找到compilerOptions配置项，将skipLibCheck属性设置为true。该配置只会跳过node_modules目录下所有第三方库的类型校验，不会影响业务代码的类型检查，可快速跑通验证流程。
• 保留类型检查的兼容方案：如果不希望关闭所有库的类型检查，可以在项目的全局类型声明文件（通常为src/typings.d.ts，若不存在可自行创建）中添加以下类型补全代码：

declare module '@angular/core' {
  export type ɵɵFactoryDef<T, D extends any[]> = unknown;
  export type ɵɵInjectableDef<T> = unknown;
  export type ɵɵNgModuleDefWithMeta<T, D, I, E> = unknown;
}

该方案仅补全当前缺失的三个私有API的类型定义，不会影响其他库的类型检查逻辑。

• 长期生产可用方案：如果后续需要在生产环境长期维持该跨版本依赖状态，建议将基于Angular 10构建的依赖库升级到Angular 12版本后重新构建，从根源避免内部API变动引发的运行时未知问题。

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