Jenkins流水线lerna项目npm install报错ENOENT package.json带随机后缀

带随机数字的后缀是npm执行依赖安装时原子写入操作生成的临时文件标识，出现该报错的核心原因如下：

• 安装进程并发冲突：你在根目录执行lerna bootstrap的同时，又在dir("www")块内单独执行npm i，两个进程同时操作重叠的依赖文件（尤其是你用file:配置的软链式本地依赖、嵌套的scoped模块）时，npm会先将内容写入带随机后缀的临时文件，写入完成后再重命名为正式文件，若进程抢占资源导致重命名步骤失败，就会残留带后缀的临时文件，正式的package.json缺失触发ENOENT报错。
• lerna依赖覆盖不全：如果你的www目录没有被加入lerna.json的packages配置列表，lerna bootstrap默认只会处理根目录和配置内的包依赖，不会主动处理www目录下的file:本地依赖，因此单独在www内执行安装是必要操作，但顺序和执行逻辑错误导致了冲突。
• 环境残留或权限问题：Jenkins复用工作空间时，之前构建残留的不完整node_modules文件、Jenkins运行用户对工作空间目录没有足够读写权限，也会导致npm的临时文件重命名步骤失败，残留带随机后缀的损坏文件。

• 统一依赖管理：将www目录加入lerna.json的packages字段，示例配置：

{
  "packages": ["packages/*", "www"],
  "npmClient": "npm"
}

配置后只需要在根目录执行一次lerna bootstrap，就会自动处理所有包包括www目录下的file:本地依赖，不需要在www目录单独执行npm i，从根源避免并发安装冲突。

• 调整安装执行逻辑：如果www目录无法纳入lerna管理，将两个安装步骤串行执行，等待根目录安装完全结束后再进入www目录执行安装，同时给npm i增加关闭原子写入的参数避免临时文件问题：

  stage("Install") {
    sh "npm ci && ./node_modules/.bin/lerna bootstrap"
  }
  dir("www") {
    stage('Build') {
      // 增加--atomic false关闭原子写入，避免临时文件残留
      sh "npm i --atomic false"
    }
  }
  

• 前置清理工作空间：每次构建前增加清理步骤，删除残留的依赖文件，避免历史损坏文件影响构建：

  stage("Clean") {
    sh "rm -rf node_modules www/node_modules package-lock.json www/package-lock.json"
  }
  

• 检查Jenkins目录权限：确保Jenkins运行用户对构建工作空间目录有完整的读写执行权限，避免写入时权限不足导致重命名失败。

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