Azure Pipeline构建npm install步骤报错 返回码4294963238

核心报错特征 #

故障触发于npm install执行环节，运行环境为Windows 10，配套版本为Node v6.17.1、npm v3.10.10，关键错误信息如下：

error code ENOTDIR
error errno -4058
error syscall open
error ENOENT: no such file or directory, open 'D:\a\45\s\Presentation  Tier\VendorPortal.Web.UI\node_modules\.staging\@types\node-b1eb4de5\package.json'
Error: Npm failed with return code: 4294963238

已尝试操作：删除package-lock.json、执行npm cache clean、全局更新npm至最新版，问题未解决。

故障原因 #

该问题是npm 3.x版本在Windows平台的已知缺陷：旧版本npm处理@types/xxx这类scoped作用域包时，临时staging目录的路径解析逻辑存在bug，加上项目路径中Presentation Tier目录包含空格，会进一步触发路径转义失败；另外Node 6.x早已在2019年终止维护，自带的npm 3.x版本和后续发布的大量npm包存在兼容性问题，强行在Node 6环境下安装最新版npm还会额外引发版本兼容冲突，这也是之前升级npm操作无效的核心原因。

修复步骤（按优先级排序） #

• 优先升级Node.js到维护期LTS版本
  直接安装Node 18.x/20.x这类长期支持版本，新版Node自带的npm 8+/9+已经完全修复了scoped包解析、带空格路径处理的相关bug，升级后删除残留的node_modules目录重新执行install即可，这是解决该问题最彻底的方案。
  从报错路径D:\a\45\s\判断该场景大概率是在Azure DevOps类CI流水线中执行构建，直接在流水线配置中添加Node版本切换步骤，指定使用16+以上的Node版本即可，不要使用环境默认预装的Node 6.x。
• 若暂时无法升级Node版本，执行全量清理后重装
  1. 先关闭所有占用项目目录的进程：包括编辑器、终端、正在运行的node服务，避免文件被锁定无法删除
  2. 完全删除node_modules目录：CMD下执行rmdir /s /q node_modules，PowerShell下执行Remove-Item -Recurse -Force node_modules，不要只删lock文件
  3. 执行npm cache verify校验缓存完整性，不要用npm cache clean，旧版本npm的clean命令容易导致缓存结构损坏
  4. 执行npm install --no-optional跳过可选依赖安装，减少staging目录的并发写入冲突
• 规避路径问题
  将项目移动到无空格、无特殊字符的纯英文短路径下（例如D:\work\project），再执行安装操作，避免旧版npm路径转义失败。

注意：Node 6.x 最高兼容的npm版本为npm 6.x，不要在该环境下强行安装npm 7+版本，否则会出现更多兼容性异常。

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