Jenkins并行流水线中npm ci处理Monorepo本地依赖冲突求助

这个场景我在维护Monorepo CI流程时确实遇到过，本质是npm ci处理本地路径依赖时的默认行为——当多个项目并行安装依赖时，它们会同时操作共享的base模块的node_modules，导致互相干扰。下面给你几个实用的解决思路：

1. 先单独安装base依赖，再并行安装UI项目 #

这是最快的临时解决方案，核心是提前确保base的依赖已经安装完成，避免UI项目的npm ci操作去修改base的node_modules：

• 在Jenkins pipeline中，先添加一个串行步骤：

  cd base && npm ci
  

• 之后再并行执行ui1和ui2的npm ci命令：

  # ui1的步骤
  cd ui1 && npm ci
  # ui2的步骤
  cd ui2 && npm ci
  

这样UI项目在安装时，base已经有了完整的node_modules，npm ci不会再去清理或重新安装base的依赖，自然不会出现冲突。

2. 改用npm Workspaces管理Monorepo（长期最优解） #

npm官方的Workspaces功能就是为Monorepo场景设计的，能彻底解决本地依赖的管理问题，不需要手动配置file:路径依赖：

1. 在根目录的package.json中添加workspaces配置：

   {
     "name": "myProject",
     "workspaces": [
       "base",
       "ui1",
       "ui2"
     ]
   }
   

2. 修改ui1和ui2的package.json，把base依赖改成正常的包引用（不需要file路径）：

   "dependencies": {
     "base": "*"
   }
   

3. 在Jenkins中只需要在根目录执行一次npm ci，npm会自动处理所有子包的依赖安装，包括内部包的关联，完全不会出现并行操作的冲突。如果需要并行构建UI项目，也可以基于已安装好的依赖单独执行每个项目的构建命令。

3. 给Jenkins安装步骤加互斥锁（保守临时方案） #

如果暂时不想调整项目结构或依赖配置，可以通过Jenkins的锁机制避免两个UI项目同时执行npm ci：

• 使用Jenkins的Lockable Resources插件，定义一个名为base-deps-lock的锁资源
• 在ui1和ui2的npm ci步骤中，添加锁的引用，确保同一时间只有一个项目能执行依赖安装
  这种方式会牺牲部分并行构建的速度，但能快速解决冲突问题，适合紧急修复场景。

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