Jenkins容器中Gradle执行npmInstall失败及Node重复下载问题排查

我来帮你一步步排查这个问题，结合你描述的容器环境和Windows开发机的差异，咱们从几个关键点入手：

1. 先搞定那个错误的Node路径 #

从报错提示/var/jenkins/workspace/Portal_RTC/liferay-workspace/build/node/node..来看，这明显是路径拼接时出了低级错误——多了个多余的点。大概率是Gradle的node插件配置里的路径变量写错了。

• 去项目根目录或者themes/portlet-layout/-portal-layouttpl下的build.gradle里找gradle-gulp插件或node插件的配置块，比如这种：

  node {
      version = "8.10.0"
      download = true // 这可能就是强制下载Node的原因
      workDir = file("${project.buildDir}/node")
  }
  

• 既然容器里已经全局装了Node，直接禁用自动下载，指定全局路径就行：

  node {
      download = false
      nodeExec = "/usr/bin/node" // 先在容器里用`which node`确认实际路径，替换成这个
  }
  

2. 阻止Gradle自动下载Node #

你说容器里已经装了Node，但Gradle还跑去Liferay镜像下载，这是因为gradle-node-plugin默认开了自动下载开关。得全局把这个开关关掉：

• 在项目根目录的build.gradle里加这段配置：

  plugins {
      id "com.github.node-gradle.node" version "3.4.0" // 确保插件版本和你用的匹配
  }
  
  node {
      download = false
      // 如果全局Node不在默认PATH里，用这段自动找路径
      nodeExec = "${System.getenv('PATH').split(':').find { it.contains('node') }}/node"
  }
  

• 顺便检查下gradle.properties里有没有node.download=true这种配置，有的话改成false，避免被覆盖。

3. 让Gradle复用项目里的node_modules #

Windows开发机上是把node_modules复制到各项目里的，容器环境里得让Gradle识别到这些本地依赖，别每次都重新装：

• 在对应模块的build.gradle里给npmInstall任务加配置，指定用项目本地的node_modules：

  npmInstall {
      args = ['--no-package-lock', '--no-fund']
      workingDir = file("${project.projectDir}") // 强制用项目根目录的node_modules
  }
  

• 拉取代码后，要么先手动跑一次npm install，要么确保项目里已经包含了完整的node_modules（比如开发机已经提交到代码仓库了），还要注意Jenkins用户对这个目录有读写权限，别因为权限不够搞砸。

4. 验证环境变量和权限是否真的生效 #

虽然你说PATH配置好了，但Jenkins容器里的环境变量有时候不一定能被Gradle继承，得验证下：

• 在Jenkins的构建步骤里先加个“执行shell”，跑这几行命令：

  echo $PATH
  which node
  node --version
  npm --version
  

• 看看输出的Node路径和版本是不是你预期的，同时检查build/node和node_modules目录的权限，确保Jenkins用户能读写这些文件夹。

5. 排查Windows和Linux的路径差异 #

Windows环境正常，容器出问题，很可能是路径分隔符的锅——Windows用\，Linux用/。检查下build.gradle里有没有硬写Windows风格的路径，比如：

// 错误示例：硬编码Windows路径
nodeExec = "C:\\Program Files\\nodejs\\node.exe"

改成Linux的绝对路径，或者用file()方法让Gradle自动适配系统路径。

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