Jenkins Pipeline中使用xmlstarlet查询XML指定元素报错排查

报错来自两个核心问题：

• Groovy语法规则限制：Jenkins Pipeline基于Groovy实现，单引号包裹的字符串不会做变量插值，你写的script: 'xxx${var}xxx'里的${var}会被原样传给shell，xmlstarlet拿到的XPath里根本没有实际的版本号，自然判定谓词语法无效。
• XPath路径错误：你的XML根节点是<versions>，目标节点是它的子节点<version>，原来写的/version[.=xxx]从根节点直接找version节点，就算变量替换成功也匹配不到任何值。

方案1：Groovy插值写法（简单直接） #

用三双引号包裹shell脚本块，让Groovy先完成变量替换，同时修正XPath路径：

// 先清理参数前后可能存在的空格、换行
def targetVer = params.version_to_read.trim()
def matchResult = sh(
    returnStdout: true,
    // 三双引号支持Groovy插值，同时保留shell脚本格式
    script: """
        xmlstarlet sel -t -v "/versions/version[.='${targetVer}']" -n maven-metadata.xml
    """.trim()
).trim() // 清理返回结果前后的多余换行

执行后matchResult就是匹配到的版本号，没匹配到的话会是空字符串。

方案2：环境变量传参写法（更安全，避免特殊字符报错） #

如果传入的版本号可能带引号、斜杠这类特殊字符，推荐用环境变量传参，完全避开Groovy插值和引号嵌套的问题，xmlstarlet原生支持读取环境变量做匹配：

def matchResult = sh(
    returnStdout: true,
    // 三单引号包裹的内容Groovy不会做任何替换，避免语法冲突
    script: '''
        xmlstarlet sel -t -v "/versions/version[.=env('TARGET_VER')]" -n maven-metadata.xml
    ''',
    // 把参数注入到shell的环境变量里
    environment: [
        TARGET_VER: params.version_to_read.trim()
    ]
).trim()

• 如果执行时提示找不到maven-metadata.xml，把文件名换成文件的绝对路径即可，比如${WORKSPACE}/maven-metadata.xml
• 可以在拿到matchResult后加个空值判断，匹配不到版本时主动抛出异常，避免后续流程执行错误
• 不要在Groovy的单引号字符串里尝试引用变量，单引号内的所有内容都会被当做字面量处理，这是Pipeline里写shell命令最常见的坑

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