NestJS Monorepo微服务运行提示找不到'@work/contracts/dist/adresses'模块

核心错误原因 #

TypeScript 无法定位到导入路径@work/contracts/dist/adresses对应的模块或类型声明，按优先级从高到低排查以下问题：

1. 包名/导入路径拼写错误 #

• 首先确认包名匹配：你当前work应用根目录的package.json声明的包名为@work/create，和你导入用的@work/contracts前缀完全不符。如果contracts是work应用下的独立子包，请检查contracts目录自身的package.json中name字段是否为@work/contracts；如果是work应用下的普通目录，直接调整导入路径为相对路径或者配置TS别名即可。
• 检查拼写错误：你导入的路径后缀为adresses，注意英文"地址"的复数正确拼写为addresses，确认你本地的目录/文件命名是否和导入拼写完全一致，少字多字都会触发找不到模块错误。

2. Monorepo内部依赖未正确关联 #

如果你是用npm/yarn/pnpm的workspace能力管理Monorepo：

• 请在workers应用的package.json的dependencies字段中添加内部依赖声明，示例如下（pnpm写法，npm/yarn可替换为对应版本号或file:相对路径）：

{
  "dependencies": {
    "@work/contracts": "workspace:*"
  }
}

• 配置完成后重新执行pnpm install/npm install，确保内部包被正确link到workers应用的node_modules目录下。

3. TypeScript路径别名未配置 #

如果你不想通过workspace link依赖，而是用TS别名直接引用源码：

• 在workers应用的tsconfig.json（或Monorepo根目录的公共tsconfig.json）中配置paths别名，示例如下：

{
  "compilerOptions": {
    "baseUrl": ".", // 这里要根据你tsconfig存放的位置调整
    "paths": {
      "@work/contracts/*": ["../work/contracts/*"] // 替换为contracts目录相对于baseUrl的实际路径
    }
  }
}

4. 构建产物未生成 #

你导入的是dist目录下的产物，需要先确认@work/contracts包已经完成构建：

• 检查contracts目录下是否存在dist文件夹，且dist下有对应的adresses.js和adresses.d.ts文件
• 如果是开发环境跑实时编译，建议直接引用源码而非dist产物，避免每次修改都要重新构建才能生效。

5. NestJS Monorepo专属配置检查 #

如果你是用Nest CLI自带的Monorepo能力创建的项目，请检查根目录的nest-cli.json配置：

• 确认work和workers两个项目的root、sourceRoot路径配置正确
• 如果你需要引用其他项目的源码，确认配置了compilerOptions.assets和compilerOptions.tsConfigPath，确保跨项目文件会被正确编译处理。

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