升级Lerna至8.1.7后单仓项目无法识别包求助

问题现象 #

将Lerna从7.x版本升级到8.1.7后，单仓项目出现构建失败，核心异常表现为：

• 执行npx lerna list返回found 0 packages，无法识别子包
• 但npx lerna clean能正常清理所有子包的node_modules目录
• yarn workspaces info可正常显示所有子包及依赖关系
• 团队其他成员、GitHub CI/CD环境以及本人另一台电脑均无此问题，从零创建的测试项目也复现相同故障

测试项目配置 #

根目录package.json #

{
  "private": true,
  "workspaces": [
    "packages/*"
  ],
  "name": "lernatest",
  "version": "1.0.0",
  "main": "index.js",
  "license": "MIT",
  "dependencies": {
    "lerna": "^8.1.7"
  }
}

子包patata（packages/patata/package.json） #

{
  "name": "patata",
  "version": "1.0.0",
  "scripts": {
    "build": "echo \"build patata\""
  },
  "dependencies": {
    "patato": "1.0.0"
  }
}

子包patato（packages/patato/package.json） #

{
  "name": "patato",
  "version": "1.0.0",
  "scripts": {
    "build": "echo \"build patatb\""
  }
}

lerna.json #

{
  "$schema": "node_modules/lerna/schemas/lerna-schema.json",
  "version": "1.0.0",
  "npmClient": "yarn"
}

已尝试的无效操作 #

• 清理Yarn缓存（yarn cache clean）
• 删除本地~/.yarn目录
• 检查项目文件权限
• 执行npx lerna clean后重新安装依赖
• 重新克隆项目仓库

排查方向 #

1. 显式指定Lerna的包扫描路径
   Lerna 8.x优化了包检测逻辑，可在lerna.json中显式添加packages字段，明确指定子包路径：

   {
     "$schema": "node_modules/lerna/schemas/lerna-schema.json",
     "version": "1.0.0",
     "npmClient": "yarn",
     "packages": ["packages/*"]
   }
   

   修改后执行npx lerna list验证是否能识别子包。

2. 检查本地Yarn/Node的全局配置

   • 执行yarn config list，查看是否存在workspaces相关的异常配置，比如workspaces-experimental是否被错误启用
   • 检查环境变量：执行echo $LERNA_PACKAGES，确认是否存在干扰Lerna包扫描的全局变量

3. 避免Lerna全局版本与本地版本冲突

   • 执行lerna -v，若存在全局安装的Lerna版本，先卸载全局版本：

     npm uninstall -g lerna
     # 或使用yarn卸载
     yarn global remove lerna
     

   之后仅使用项目本地安装的Lerna（npx lerna list）测试。

4. 验证文件系统大小写敏感性
   确认packages目录名称与配置中的"packages/*"完全一致，子包目录名与package.json中的name字段拼写（含大小写）匹配，避免因文件系统大小写不敏感导致的扫描异常。

5. 查看Lerna调试日志
   执行npx lerna list --verbose，通过详细调试日志定位Lerna扫描子包时的具体错误，比如目录访问权限、扫描路径异常等信息。

6. 测试Yarn版本兼容性
   当前使用Yarn 1.22.22，尝试升级到Yarn 1.x最新稳定版，或临时切换为npm作为包管理器，验证是否为Yarn与Lerna 8.x的兼容性问题。

内容的提问来源于stack exchange，提问作者David B.