使用Jenkins文件参数上传文件时参数为空的问题排查

问题根源 #

在声明式流水线里使用file类型参数时，params.archivo并不是字符串格式的文件路径，而是一个FileParameterValue对象。直接把它转成字符串拼接路径，会得到null，这就是你看到No existe: /var/jenkins_home/workspace/pipeline/null的原因。

解决方案 #

需要调用file参数对象的方法获取实际文件信息，以下是修正后的流水线代码：

pipeline {
    agent any
    
    parameters {
        file(name: 'archivo', description: 'Adjunta un archivo')
    }
    
    stages {
        stage ('Importar archivo') {
            steps {
                script {
                    // 获取Jenkins临时存储上传文件的绝对路径
                    def tempFilePath = params.archivo.getLocation()
                    // 获取用户上传文件的原始文件名
                    def fileName = params.archivo.getFileName()
                    // 定义工作区中的目标文件路径
                    def targetFilePath = "${env.WORKSPACE}/${fileName}"
                    
                    // 将临时文件复制到工作区
                    sh "cp ${tempFilePath} ${targetFilePath}"
                    
                    // 检查文件是否存在并读取内容
                    if (fileExists(targetFilePath)) {
                        def contenido = readFile targetFilePath
                        echo contenido
                    } else {
                        echo "No existe: ${targetFilePath}"
                    }
                }
            }
        }
    }
}

关键方法说明 #

• getLocation()：返回Jenkins服务器临时存储上传文件的绝对路径，这个文件是Jenkins接收上传后自动生成的临时文件
• getFileName()：返回用户本地上传时的原始文件名，确保复制到工作区后的文件名和用户上传的一致

额外注意事项 #

• 临时文件会在流水线结束后被Jenkins自动清理，必须复制到工作区才能保留或用于后续步骤
• 如果Jenkins运行在容器中，要确保临时文件所在目录和工作区目录在同一存储卷内，避免cp命令跨卷失败

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