GCP上Jenkins流水线调用getVersion方法遇语法错误求助

错误原因分析 #

1. Shell命令变量插值触发语法错误
   你的sh "echo Found version [Version $foundVersion]"语句中，Groovy会先将$foundVersion替换为实际值再传递给shell执行。如果foundVersion包含(、)或其他shell特殊字符（比如XML节点toString()返回的带标签内容），shell会将这些字符解析为语法结构，直接触发syntax error near unexpected token '('错误。

2. @NonCPS方法的文件访问错误
   标记了@NonCPS的getVersion方法中使用new File(path)，会直接访问Jenkins控制器的文件系统，而不是node块指定的代理节点文件系统——你checkout的代码是在代理节点上的，这意味着方法实际读取的不是你期望的version.xml，甚至可能找不到文件。

3. XML节点内容获取方式错误
   XmlSlurper.parse()返回的是GPathResult对象，直接调用toString()会返回包含XML标签的完整节点内容，而非纯版本号文本，这会引入大量特殊字符，进一步加剧shell解析问题。

解决步骤 #

1. 修正Shell命令的变量传递 #

使用环境变量传递值给shell，避免Groovy插值导致的shell语法冲突：

withEnv(["FOUND_VERSION=$foundVersion"]) {
  sh 'echo Found version [Version $FOUND_VERSION]'
}

或者转义Groovy中的$，让shell自己处理变量：

sh "echo Found version [Version \$foundVersion]"

2. 修复文件读取逻辑 #

使用Jenkins流水线内置的readFile方法读取代理节点上的文件，同时移除不必要的@NonCPS标记（XmlSlurper可在CPS环境下正常运行）：

String getVersion(String path) {
  def xmlContent = readFile(path)
  def versionNode = new XmlSlurper().parseText(xmlContent)
  return versionNode.text() // 获取节点的纯文本内容，而非XML结构
}

注意：如果你的version.xml结构特殊（比如版本号在某个子节点），需要调整versionNode.text()的路径，比如versionNode.version.text()。

3. 完整修正后的流水线代码 #

import groovy.xml.XmlSlurper

String getVersion(String path) {
  def xmlContent = readFile(path)
  def versionNode = new XmlSlurper().parseText(xmlContent)
  return versionNode.text()
}

node {
  withEnv (['versionFileName=version.xml']) {
    stage('checkout') {
      cleanWs()
      checkout scm
    }
    stage('Version') {
      def foundVersion = getVersion("${versionFileName}")
      withEnv(["FOUND_VERSION=$foundVersion"]) {
        sh 'echo Found version [Version $FOUND_VERSION]'
      }
    }
  }
}

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