Angular 8迁移至13构建自定义库报Data path "/error" must be string错误

一、报错含义解析 #

这个报错是Angular构建链路吞错导致的无效提示，不是业务代码本身直接触发的错误：

• 前缀的Compiling with Angular sources in Ivy partial compilation mode仅表示当前正在使用Angular 13默认的库构建模式（Ivy部分编译）执行构建，不属于错误提示。
• 核心报错Data path "/error" must be string的本质是：构建流程中某个内部插件捕获到了真实的编译/配置错误，但在按照CLI规范组装错误对象时，给error字段传入了非字符串类型的值（比如错误对象、undefined、null），导致构建系统的Schema校验规则先触发了异常，把真正的原始错误完全覆盖了。

部分库能正常构建的原因很简单：这些库的配置、代码完全兼容Angular 13，构建全程没有触发任何原始错误，自然不会走到这个有bug的错误抛出逻辑。

目前同类问题的高频根因主要有几类：

• 自定义库的配置文件残留了Angular 8时代的废弃参数，比如ng-package.json里的老版构建配置、tsconfig里写死的enableIvy: false等
• 本地依赖版本不一致：比如ng-packagr版本和Angular主版本不匹配、多个库依赖的Angular包版本不统一、残留了Angular 8版本的核心依赖
• 库代码里引用了Angular 13中已移除的废弃API，或者依赖了未做Ivy兼容的第三方老版本Angular库
• 库的package.json中peerDependencies声明的Angular版本范围停留在8.x，和当前安装的13.x版本冲突

二、获取详细错误日志的可行方法 #

按排查效率从高到低排序：

1. 开启构建全量日志输出，在构建命令后追加verbose参数，执行后会打印完整的构建插件加载、配置解析、编译执行全链路日志，通常能在Schema校验报错抛出前看到被吞掉的原始错误详情：

   ng build <你的自定义库名> --verbose
   

2. 禁用构建缓存重新构建，Angular 13默认开启磁盘构建缓存，残留的老版本构建缓存经常会导致错误信息截断：

   ng build <你的自定义库名> --no-cache
   

3. 检查本地Angular相关依赖的版本一致性，执行以下命令查看所有安装的Angular核心包、CLI、ng-packagr的版本，确保所有相关包版本统一对齐到13.x，不存在多版本共存的情况：

   npm ls @angular/core @angular/cli ng-packagr
   

   绝大多数同类报错都是依赖版本不匹配触发的，对齐版本后问题会直接消失。
4. 临时切换编译模式绕开partial编译的吞错逻辑：打开出问题的库对应的tsconfig.lib.json，在angularCompilerOptions配置项中，将compilationMode的值从partial改为full，重新执行构建。full编译模式不会走partial模式的错误组装逻辑，通常可以直接抛出具体的错误代码位置、配置问题点，排查完成后记得将配置改回partial（Angular库发布要求必须使用partial编译模式）。

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