Nx monorepo执行nx test测试Angular时找不到内部依赖库

我搭建了一个Nx monorepo项目，包含client、server两个应用，以及client-core、platform-core等共5个内部库。我通过在tsconfig.json中配置paths字段，将这些内部库引入Angular（client）应用，配置内容如下：

"paths": {
  "@myorg/platform-core": [
    "../../libs/platform-core/src/index.ts"
  ],
  "@myorg/client-core": [
    "../../libs/client-core/src/index.ts"
  ],
},

该配置目前运行正常：IDE可正常解析依赖库路径，执行ng serve命令也能正常启动应用。但当我执行npx nx test client命令测试Angular应用时，系统提示无法找到对应内部库，报错信息如下：

FAIL  apps/client/src/app/core/guards/patient.guard.spec.ts
  ● Test suite failed to run

    apps/client/src/app/core/guards/patient.guard.spec.ts:4:36 - error TS2307: Cannot find module '@myorg/client-core' or its corresponding type declarations.

    4 import { EnvironmentService } from '@myorg/client-core';
                                         ~~~~~~~~~~~~~~~~~~~

我曾尝试将相同的paths配置添加到tsconfig.spec.json中（理论上无需该操作，因为该文件已通过"extends": "./tsconfig.json"字段继承了基础tsconfig的配置），但该操作未产生任何效果。请问需要完成哪些配置，才能在spec测试文件中正常引用这些内部库？

这个问题的核心原因是Jest不会自动读取tsconfig中的paths路径映射规则，和tsconfig的继承逻辑没有关系，按以下步骤修复即可：

• 优先检查client应用下的Jest配置文件（通常是jest.config.ts或jest.config.js），确认是否配置了moduleNameMapper字段。Nx默认用Jest跑单元测试，模块解析规则完全由Jest自身控制，不会复用TypeScript的路径映射。
  如果你用的是ts-jest作为测试预处理器，可以直接引入官方工具自动拉取tsconfig里的映射规则，不需要手动重复配置：

  const { pathsToModuleNameMapper } = require('ts-jest');
  const tsConfig = require('./tsconfig.json');
  
  export default {
    // 其余已有Jest配置保持不变
    moduleNameMapper: pathsToModuleNameMapper(tsConfig.compilerOptions.paths, {
      prefix: '<rootDir>/'
    })
  }
  

  如果你没有用ts-jest，直接手动写匹配规则也可以，注意调整相对路径确保能定位到libs目录：

  moduleNameMapper: {
    "^@myorg/(.*)$": "<rootDir>/../../libs/$1/src/index.ts"
  }
  

• 如果Jest配置确认没问题，检查tsconfig.spec.json的include字段。默认生成的配置只会包含当前client应用目录下的测试文件、类型声明文件，不会主动纳入monorepo下libs目录的代码，手动把libs路径加入include范围即可：

  "include": [
    "**/*.spec.ts",
    "**/*.test.ts",
    "**/*.d.ts",
    "../../libs/**/*.ts"
  ]
  

• 以上配置修改完成后，先执行npx nx clear-cache清理Nx和Jest的旧缓存，再重新运行npx nx test client就可以正常解析内部库了。

补充：不建议手动在tsconfig.spec.json里重复写paths配置，这种重复配置很容易和Nx内置的路径解析规则冲突。如果内部库是通过Nx官方的库生成器（比如nx g @nx/angular:lib client-core）创建的，正常会自动完成所有路径配置，不需要手动修改tsconfig，手动添加paths反而可能打破默认的解析逻辑。

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