Windows批处理设置Jenkins字符串参数后取值为空，求排查方法

问题根源 #

Jenkins的params.Year是构建启动前就固定的只读参数，你在Windows批处理里设置的只是当前批处理进程的本地环境变量，完全无法同步更新Jenkins的params对象，所以后续步骤调用${params.Year}自然还是初始的空值。

无插件解决方法 #

方法1：捕获批处理输出赋值给环境变量（推荐） #

利用bat步骤的returnStdout属性捕获批处理的输出结果，将其赋值给Jenkins环境变量，后续步骤通过env.Year调用即可：

pipeline {
    agent any
    parameters {
        string(name: 'Year', defaultValue: '', description: '年份参数')
    }
    stages {
        stage('设置Year值') {
            steps {
                script {
                    // 替换为你的实际批处理逻辑，比如获取系统当前年份
                    def newYear = bat(script: 'echo %date:~6,4%', returnStdout: true).trim()
                    // 将值存入Jenkins环境变量
                    env.Year = newYear
                }
            }
        }
        stage('使用Year值') {
            steps {
                echo "当前Year值：${env.Year}"
                // 后续所有步骤直接用env.Year调用，不要用params.Year
            }
        }
    }
}

方法2：通过临时文件传递值 #

如果你的批处理逻辑复杂，无法直接用输出捕获，可以将值写入临时文件，后续步骤读取文件内容：

1. 批处理步骤写入文件：

@echo off
:: 替换为你实际生成的年份值
set "TARGET_YEAR=2024"
echo %TARGET_YEAR% > year_temp.txt

2. 后续步骤读取文件并使用：

stage('使用Year值') {
    steps {
        script {
            def newYear = readFile('year_temp.txt').trim()
            echo "读取到的Year值：${newYear}"
            // 可选：存入环境变量方便后续统一调用
            env.Year = newYear
        }
    }
}

关键提醒 #

Jenkins的params参数集合是只读的，构建启动后就无法修改。所有动态生成的参数值，都要通过环境变量、自定义变量或文件传递，不要试图修改params对象里的内容。

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