Angular 14集成PSPDFKit模块时构建失败求助

问题重现 #

按照PSPDFKit官方Angular集成教程操作（无自定义修改），Angular 14项目构建时出现以下TypeScript错误：

Error: node_modules/pspdfkit/dist/index.d.ts:2467:93 - error TS2344: Type 'TProps' does not satisfy the constraint 'Object'.
2467 declare function Record$1(defaultValues: TProps, name?: string): Record$1.Factory;

解决方案 #

方案1：调整TypeScript编译配置（推荐）

1. 打开项目根目录的tsconfig.json文件
2. 在compilerOptions中，将strictFunctionTypes设置为false：

   {
     "compilerOptions": {
       // 其他配置...
       "strictFunctionTypes": false
     }
   }
   

   若上述无效，可尝试将strict整体设为false（不推荐长期使用，会降低类型检查严格性）
3. 保存配置后重新执行构建命令：ng build

方案2：升级/降级PSPDFKit版本

• 执行命令更新至最新兼容版本：npm update pspdfkit
• 若最新版本仍不兼容，可查询PSPDFKit版本日志，安装适配Angular 14的特定版本：npm install pspdfkit@<兼容版本号>

方案3：临时修改类型定义文件（应急用）

1. 定位到node_modules/pspdfkit/dist/index.d.ts的第2467行
2. 修改泛型约束，将TProps显式约束为对象类型：

   declare function Record$1<TProps extends Object>(defaultValues: TProps, name?: string): Record$1.Factory;
   

   注意：此修改会在执行npm install后被覆盖，仅作为临时应急方案。

原因说明 #

Angular 14配套的TypeScript版本为~4.6.4，对泛型约束的处理逻辑与PSPDFKit当前版本的类型定义存在兼容性差异，导致编译器无法识别TProps的Object类型约束，触发TS2344错误。

内容的提问来源于stack exchange，提问作者Kaygee Del Hlobo