Nx使用run-commands构建同工作空间依赖库时报Unable to write a reference错误

问题根因 #

这个报错是@nrwl/run-commands作为中间任务触发构建时，未正确透传Angular库构建（ng-packagr）所需的路径上下文参数，导致ng-packagr计算跨文件引用路径时出错，无法写入引用信息。
单独执行base-build任务能成功，是因为Nx会直接给构建任务传递正确的库根路径、输出路径、TS配置上下文，run-commands默认不会继承和透传这些参数，才会出现路径匹配错误。

解决方案 #

按优先级依次尝试以下配置修改即可解决：

• 给run-commands任务显式指定执行根目录
  在工作区配置（angular.json/project.json）对应shiny-components:build任务的options节点下，添加cwd参数指定为当前库的根目录，示例配置：

"build": {
  "builder": "@nrwl/workspace:run-commands",
  "options": {
    "cwd": "libs/shiny-components",
    // 其他原有配置
  }
}

• 透传构建参数到子任务
  修改run-commands的command配置，显式传递任务配置参数，同时开启参数透传能力：

"build": {
  "builder": "@nrwl/workspace:run-commands",
  "options": {
    "command": "nx run shiny-components:base-build --configuration=${configuration}",
    "args": ["--configuration"],
    // 其他原有配置
  }
}

• 对齐输出路径配置
  确保run-commands任务的outputPath配置和base-build任务的outputPath完全一致，避免Nx缓存或文件锁机制阻止ng-packagr写入文件：

"build": {
  "builder": "@nrwl/workspace:run-commands",
  "options": {
    "outputPath": "dist/libs/shiny-components",
    // 其他原有配置
  }
}

• 临时验证方案
  如果需要快速定位问题，可以在run-commands的调用命令中添加--skip-nx-cache参数禁用Nx缓存，确认是否为缓存冲突导致的报错。

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