Jenkins声明式流水线使用Kubernetes代理时GERRIT_REFSPEC在Git检出阶段二次Fetch失败的问题求助

从你提供的日志和环境信息来看，核心问题出在Kubernetes代理Pod没有继承Gerrit触发器传递的GERRIT_REFSPEC环境变量：第一次Git检出（读取Jenkinsfile阶段）是在Jenkins主节点或代理初始化节点执行的，能拿到触发器参数；但流水线正式运行时，K8s代理创建的新Pod默认不会自动同步这些变量，导致二次Fetch时$GERRIT_REFSPEC无法被解析成实际的ref值。

下面是几个无需将流水线改为脚本式的可行解决方案：

方案1：在Kubernetes Agent的YAML中显式注入环境变量 #

修改你的file.yml，把GERRIT_REFSPEC作为环境变量传递给Pod里的容器：

apiVersion: v1
kind: Pod
spec:
  containers:
  - name: jnlp
    image: your-jnlp-image:tag # 替换成你实际使用的JNLP镜像
    env:
    - name: GERRIT_REFSPEC
      value: "${GERRIT_REFSPEC}"
  # 保留你原有的其他容器配置（比如构建用的maven、node等）

这样K8s代理启动的Pod就能直接获取到Gerrit触发器传递的参数，二次Fetch时就能正确解析变量了。

方案2：在声明式流水线中手动定义Git检出步骤 #

在流水线的stages里添加一个显式的Checkout阶段，手动指定Git的refspec，避免依赖自动Fetch的变量替换逻辑：

pipeline {
    agent {
        kubernetes {
            yamlFile "file.yml"
        }
    }
    stages {
        stage('Explicit Checkout') {
            steps {
                script {
                    // 用script块包裹GitSCM配置，但整体还是声明式流水线
                    checkout([
                        $class: 'GitSCM',
                        branches: [[name: "${GERRIT_REFSPEC}"]],
                        userRemoteConfigs: [[
                            url: 'ssh://[gerrit-server]/[project]',
                            credentialsId: 'gerrit',
                            refspec: "${GERRIT_REFSPEC}"
                        ]]
                    ])
                }
            }
        }
        // 你的其他业务阶段...
    }
}

这个方式通过直接指定refspec的值，绕过了自动Fetch时的变量解析问题，同时没有改变流水线的声明式结构。

方案3：确保Gerrit触发器参数被设置为构建参数 #

在Jenkins项目的配置中，把GERRIT_REFSPEC配置为构建参数，而不仅仅是环境变量：

1. 进入项目的"配置"页面
2. 勾选"This build is parameterized"选项
3. 添加一个"字符串参数"，名称设为GERRIT_REFSPEC，默认值留空（Gerrit触发器会自动填充这个值）
4. 保存配置

这样Kubernetes代理在创建Pod时，会自动将构建参数同步到Pod的环境变量中，确保二次Fetch时能拿到正确的值。

验证方法 #

应用任一方案后，重新触发Gerrit事件，查看构建日志：

• 确认第二次Fetch命令中的$GERRIT_REFSPEC被替换成了实际的ref路径（比如refs/changes/11/111111/11）
• 检查流水线是否能顺利完成Git检出阶段

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