Jenkins参数化管道中Shell脚本无法访问参数的问题

你遇到的问题主要来自两个核心点：Jenkins变量在Shell脚本中的解析问题，以及jq命令的动态字段访问语法错误，我来一步步帮你修复：

问题原因拆解 #

1. 单引号阻断变量插值：你用了三重单引号(''')包裹Shell脚本，这种写法下Jenkins不会对内部的${params.Instance}做任何变量替换，会直接把这个Jenkins语法的字符串传给Shell。而Shell根本不认识params这个Jenkins对象，所以抛出了bad substitution错误。
2. jq动态字段写法错误：就算变量能正常传递，.rdpEnv.${params.Instance}.keyName这种写法在jq里也是无效的——当字段名是动态变量时，必须用[]语法来访问，不能直接用点号拼接。

修复后的脚本示例 #

推荐用双引号包裹Shell脚本（让Jenkins先解析参数），同时结合jq的--arg参数安全传递变量，避免注入风险：

node {
    echo "Download files from FTP"
    sh """
        # 把Jenkins参数赋值给Shell变量（可选，但逻辑更清晰）
        SELECTED_INSTANCE=${params.Instance}
        
        # 用jq的--arg传递变量，动态访问JSON字段
        keyName=\$(cat ServerDetails.json | jq --arg inst "\$SELECTED_INSTANCE" '.rdpEnv[\$inst].keyName')
        
        # 验证结果（可选，方便排查问题）
        echo "获取到的keyName: \$keyName"
    """
}

关键修改说明 #

• 替换'''为"""：Jenkins会先将${params.Instance}替换成实际的参数值，再把处理后的脚本传给Shell执行。注意Shell自身的变量要加\$转义（比如\$SELECTED_INSTANCE），防止被Jenkins误解析成Groovy变量。
• 使用jq的--arg参数：把Shell变量SELECTED_INSTANCE传递给jq的inst变量，再用.rdpEnv[$inst]动态访问JSON字段，这是jq处理动态字段的标准且安全的方式。

另一种简洁写法：先存Groovy变量 #

如果你更习惯在Groovy层面处理参数，也可以先把Jenkins参数赋值给Groovy变量，再传递给Shell：

node {
    echo "Download files from FTP"
    // 将Jenkins参数存入Groovy变量
    def selectedInstance = params.Instance
    
    sh """
        keyName=\$(cat ServerDetails.json | jq --arg inst "${selectedInstance}" '.rdpEnv[\$inst].keyName')
        echo "获取到的keyName: \$keyName"
    """
}

额外注意事项 #

• 如果你的参数值包含空格、特殊字符（比如!、@），--arg参数会自动处理这些情况，比直接字符串拼接更安全。
• 加个echo命令验证变量值，能快速排查是否成功获取到预期结果。

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