使用Yarn Berry v4.3.1 + NestJS时ts-api-utils对等依赖问题

• 第一步：确认警告细节
  运行yarn install，复制完整的警告信息，重点查看ts-api-utils要求的TypeScript版本范围（比如是否要求>=4.7.0而非仅>=4.2.0），这能精准定位版本不匹配的核心问题。

• 第二步：锁定TypeScript的具体兼容版本
  将package.json里的typescript版本从>=4.2.0改回具体的兼容版本（比如你原本的^5.1.3）——范围过宽的版本号可能导致Yarn解析到不符合ts-api-utils要求的TS版本。修改后devDependencies中的对应行应为：

  "typescript": "^5.1.3"
  

• 第三步：显式添加匹配版本的ts-api-utils
  ts-api-utils是@typescript-eslint工具链的依赖，显式安装和你的@typescript-eslint版本一致的ts-api-utils，可避免Yarn自动解析时的版本偏差。执行命令：

  yarn add -D ts-api-utils@^7.0.0
  

  注意版本号要和devDependencies里的@typescript-eslint/eslint-plugin、@typescript-eslint/parser保持统一（你的配置中为^7.0.0）。

• 第四步：清理缓存并重装依赖
  缓存异常可能导致依赖解析错误，执行以下命令：

  yarn cache clean
  yarn install
  

• 第五步：放宽对等依赖检查（兜底方案）
  若以上步骤均无效，可临时调整Yarn的对等依赖严格性。在项目根目录的.yarnrc.yml中添加：

  strictPeerDependencies: false
  

  注意：优先通过版本匹配解决问题，关闭严格检查仅作为临时兜底，避免潜在的依赖风险。

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