Jenkins流水线多阶段切换Agent报错：hudson.Launcher缺失如何解决？

首先看你碰到的MissingContextVariableException: Required context class hudson.Launcher is missing错误，主要由两个问题导致：

1. 流水线语法结构错误 #

你当前的配置里，后面两个Git Checkout阶段没有包裹在stages代码块内部！Jenkins声明式流水线要求所有stage必须放在stages块里，这种语法错误会让流水线上下文解析异常，进而触发这个报错。

2. 无Agent阶段的步骤依赖节点上下文 #

如果某个阶段确实不需要执行构建操作（比如你的Print Debug Vars），但如果该阶段里包含了需要运行在节点上下文的步骤（比如withCredentials、打印环境变量的操作），仅注释// No node required是没用的——这类步骤依赖hudson.Launcher上下文，必须绑定到某个Agent节点才能执行。

正确的多Agent流水线配置示例 #

下面是修正后的配置，既保证了语法合规，又能实现不同阶段灵活切换Agent：

pipeline {
    agent none  // 全局不指定默认Agent，每个阶段按需配置
    stages {
        stage("Print Debug Vars") {
            // 若该阶段有依赖上下文的步骤，指定一个可用Agent（比如用集群里的通用节点）
            agent { label 'docker' } 
            steps {
                // 示例：使用凭证、打印节点信息等操作
                withCredentials([string(credentialsId: 'my-api-token', variable: 'API_TOKEN')]) {
                    echo "Debug token: ${API_TOKEN}"
                }
                echo "Current running node: ${NODE_NAME}"
            }
        }
        stage("Git Checkout (Docker Node)") {
            agent { label 'docker' }
            steps {
                checkout scm
                // 执行Docker相关操作
                sh 'docker --version'
            }
        }
        stage("Ansible Deployment") {
            agent { label 'ansible' }
            steps {
                // 执行Ansible部署操作
                sh 'ansible --version'
                sh 'ansible-playbook deploy.yml'
            }
        }
    }
}

额外说明 #

• 如果某个阶段真的完全不需要Agent（比如只是纯逻辑判断，没有任何需要节点执行的步骤），可以指定agent none，但要确保该阶段的steps里没有依赖节点上下文的操作：

  stage("Pure Logic Check") {
      agent none
      steps {
          script {
              def isProd = params.DEPLOY_ENV == 'production'
              echo "Production deployment flag: ${isProd}"
          }
      }
  }
  

• 每个阶段指定Agent后，Jenkins会自动在对应节点上启动执行环境，阶段执行完成后会释放节点，天然实现多Agent的切换。

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