如何调整Jenkins流水线工作目录解决Maven项目POM读取失败问题

核心配置逻辑 #

调整执行路径不需要改动Jenkins主程序的全局路径参数，直接在Pipeline代码层定向指定执行目录即可，两层配置即可覆盖所有场景：一是替换默认工作空间的根路径指向，二是通过Maven参数显式锁定POM文件位置，从根源避免路径偏移导致的读取失败。

具体Pipeline代码配置 #

根据团队常用的Pipeline写法，分两种场景适配：

1. 声明式Pipeline（团队主流标准写法） #

有两种路径生效方式可选择：

• 全局全流水线路径替换：所有stage的执行路径统一切换到目标目录，无需单步重复写路径
  示例代码：

  pipeline {
    agent any
    options {
      // 覆盖默认/opt/jenkins/workspace的根工作路径，全局生效
      workspace '/var/jenkins_home/workspace'
    }
    stages {
      stage('拉取代码') {
        steps {
          git '项目Git仓库地址'
        }
      }
      stage('Maven打包') {
        steps {
          // 打印当前执行路径，校验路径是否配置生效
          sh 'pwd'
          // 双保险：显式指定POM文件相对路径，避免Maven搜索路径偏移
          sh 'mvn clean package -f ./pom.xml'
        }
      }
    }
  }
  

• 单stage定向路径切换：如果不需要改动全局路径，仅针对Maven构建环节切换执行目录，用dir指令包裹构建步骤即可
  示例代码：

  stage('Maven打包') {
    steps {
      // 进入目标项目路径执行后续所有构建命令
      dir('/var/jenkins_home/workspace/你的项目名') {
        sh 'mvn clean package'
      }
    }
  }
  

2. 脚本式Pipeline（老版本兼容写法） #

直接用ws块包裹所有构建步骤，替换默认工作目录：

node {
  // 指定自定义工作目录，替换默认的/opt路径
  ws('/var/jenkins_home/workspace/你的项目名') {
    git '项目Git仓库地址'
    sh 'mvn clean package'
  }
}

常见踩坑排查 #

配置完成后如果仍然报POM读取错误，按以下顺序排查：

• 检查目录权限：确认Jenkins进程的运行用户对/var/jenkins_home/workspace目录有读写执行权限，权限不足会导致代码拉取不完整、POM文件无法读取，可通过ps -ef | grep jenkins确认运行用户，通过ls -ld 目标目录校验属主是否匹配。
• 锁定POM绝对路径：在Maven执行命令中直接用-f参数显式指定POM的全路径，例如mvn clean package -f /var/jenkins_home/workspace/你的项目名/pom.xml，避免Maven按默认搜索路径找文件导致的UNABLE TO READ POM报错。
• 清理残留缓存：删除旧路径/opt/jenkins/workspace下的项目残留文件，避免构建时误加载旧路径的缓存文件导致路径混乱。

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