Jenkins如何配置节点标签故障转移，指定节点不可用时优先切换备用节点

• 原脚本用||拼接标签的写法，本质是告诉Jenkins「所有匹配这几个标签的节点都可以用」，Jenkins调度器会从所有匹配的在线空闲节点里随机选择，完全没有优先级顺序，自然会出现随机选节点的效果，和agent any逻辑接近。
• Groovy中单引号包裹的字符串不会执行变量插值，你写的'${params.NODE_LABELS} || Failover || Failover2'不会替换${params.NODE_LABELS}为用户实际传入的节点值，会直接把这串字符当成标签表达式解析，匹配逻辑完全失效。
• 脚本里写的备用标签是大写开头的Failover/Failover2，和你实际配置的小写failover/failover2标签大小写不匹配，Jenkins标签是大小写敏感的，这也会导致标签匹配异常。
• 你在Pipeline块外直接写逻辑赋值BUILD_NODE的写法存在执行顺序问题，声明式Pipeline执行时，块外代码会在参数初始化前运行，大概率拿不到params里的实际传入值，进一步导致标签配置错误。
• Jenkins原生标签表达式本身就不支持「按优先级依次尝试节点→备用节点全不可用时回退等待最高优先级节点」的调度逻辑，单纯靠静态label配置不可能实现你的需求。

要实现你需要的调度逻辑，必须放弃静态标签配置，改用Pipeline脚本按优先级顺序动态抢占节点，参考实现如下：

pipeline {
    agent none // 关闭全局静态agent，走动态调度逻辑
    parameters {
        booleanParam(name: 'DEBUG_JOB', defaultValue: false, description: '调试模式开关，开启后仅使用指定节点不调度备用节点')
        string(name: 'NODE_LABELS', defaultValue: 'node1', description: '指定任务优先运行的目标节点标签，如node1/node2')
    }
    stages {
        stage('构建执行') {
            steps {
                script {
                    // 按优先级从高到低组装候选节点标签列表
                    def candidateLabels = [params.NODE_LABELS]
                    // 非调试模式追加备用节点
                    if (params.DEBUG_JOB != 'true') {
                        candidateLabels.add('failover')  // 对应node3的标签，注意和实际配置大小写一致
                        candidateLabels.add('failover2') // 对应node4的标签
                    }

                    def taskExecuted = false
                    // 按顺序尝试抢占空闲节点，0秒超时即拿不到就立刻跳过
                    for (label in candidateLabels) {
                        try {
                            node(label) {
                                echo "调度成功，当前运行节点标签：${label}"
                                // 下方写实际构建逻辑，也可以把节点标签存入全局变量供后续stage使用
                                // 示例构建步骤
                                sh 'echo hello world'
                            }
                            taskExecuted = true
                            break // 抢占成功后终止循环，不再尝试低优先级节点
                        } catch (Exception e) {
                            echo "标签为[${label}]的节点繁忙/离线，尝试下一个优先级节点"
                            sleep(time: 3, unit: 'SECONDS') // 短等待避免频繁请求打满controller
                            continue
                        }
                    }

                    // 所有候选节点都不可用时，阻塞等待最高优先级的指定节点空闲
                    if (!taskExecuted) {
                        echo "备用节点全部不可用，进入队列等待指定节点[${params.NODE_LABELS}]空闲"
                        node(params.NODE_LABELS) {
                            echo "调度成功，当前运行节点标签：${params.NODE_LABELS}"
                            // 下方写实际构建逻辑
                            sh 'echo hello world'
                        }
                    }
                }
            }
        }
    }
}

注意事项 #

• 所有节点标签必须和Jenkins后台实际配置的标签大小写完全一致，否则会匹配不到对应节点。
• 抢占节点时设置0秒超时，是为了避免在低优先级节点队列排队，严格保证「指定节点→node3→node4」的尝试顺序。
• 抢占节点之间加3秒短等待，是为了避免短时间大量节点请求给controller造成额外压力，可根据实际集群规模调整时长。
• 如果需要拆分多阶段构建，可在首次抢占到节点时将当前节点标签存入全局变量，后续阶段直接指定agent为该标签即可，不用重复写调度逻辑。

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