如何在已启动的流水线中动态替换File Parameter的值？

Jenkins的File Parameter本质是存储了上传文件在工作区的临时路径，要实现后续阶段替换为工作区中的其他文件，有两种直接可行的思路：

思路1：覆盖File Parameter指向的文件路径 #

既然参数值对应一个文件路径，直接将目标文件（比如fileB.txt）复制并覆盖到该路径下，后续所有引用该参数的步骤都会自动读取新文件内容。

声明式流水线示例 #

pipeline {
    agent any
    parameters {
        file(name: 'UPLOADED_FILE', description: '初始上传的文件')
    }
    stages {
        stage('替换文件') {
            steps {
                script {
                    // 确认目标文件存在于工作区
                    def targetFile = "${WORKSPACE}/fileB.txt"
                    if (!fileExists(targetFile)) {
                        error "目标文件 ${targetFile} 不存在于工作区"
                    }
                    // 将目标文件覆盖到File Parameter的路径
                    sh "cp -f ${targetFile} ${params.UPLOADED_FILE}"
                }
            }
        }
        stage('验证替换结果') {
            steps {
                // 此时读取UPLOADED_FILE会得到fileB的内容
                sh "cat ${params.UPLOADED_FILE}"
            }
        }
    }
}

脚本式流水线示例 #

node {
    properties([
        parameters([
            file(name: 'UPLOADED_FILE', description: '初始上传的文件')
        ])
    ])

    stage('替换文件') {
        def targetFile = "${WORKSPACE}/fileB.txt"
        if (!fileExists(targetFile)) {
            error "目标文件 ${targetFile} 不存在于工作区"
        }
        sh "cp -f ${targetFile} ${params.UPLOADED_FILE}"
    }

    stage('验证替换结果') {
        sh "cat ${params.UPLOADED_FILE}"
    }
}

思路2：重新定义参数变量 #

直接在流水线中重新给参数名赋值为目标文件的路径，后续步骤引用该变量时会指向新文件。这种方式更直观，适合不需要保留原上传文件的场景。

声明式流水线示例 #

pipeline {
    agent any
    parameters {
        file(name: 'UPLOADED_FILE', description: '初始上传的文件')
    }
    stages {
        stage('替换参数指向') {
            steps {
                script {
                    def targetFile = "${WORKSPACE}/fileB.txt"
                    if (!fileExists(targetFile)) {
                        error "目标文件 ${targetFile} 不存在于工作区"
                    }
                    // 重新赋值参数变量，后续使用UPLOADED_FILE时会指向新文件
                    params.UPLOADED_FILE = targetFile
                }
            }
        }
        stage('验证替换结果') {
            steps {
                sh "cat ${params.UPLOADED_FILE}"
            }
        }
    }
}

注意事项 #

• 确保目标文件fileB.txt已经存在于Jenkins节点的工作区中（比如通过之前的拉取、生成步骤得到）。
• 如果使用Windows节点，将cp -f替换为copy /Y命令。
• 若后续步骤是调用其他插件或工具，需确认这些步骤是通过参数变量（如${params.UPLOADED_FILE}）读取文件，而非硬编码初始路径。

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