Jenkins声明式流水线file-parameter插件未按预期报错求助

base64File 参数默认未启用强制非空校验，当未传入文件时，file-parameter 插件会自动生成一个空的临时文件（命名格式如 THEFILExxxxxx.tmp），而非触发报错。这是插件的默认行为，和你预期的官方文档描述不符可能是因为文档未明确说明默认配置的差异。

1. 强制要求传入文件（最直接） #

在 parameters 配置中给 base64File 添加 required: true 属性，这样流水线启动时如果未选择文件，会直接在参数校验阶段失败，不会进入后续执行步骤：

pipeline {
  agent any
  parameters {
    base64File(name: 'THEFILE', required: true)
  }
  stages {
    stage('Example') {
      steps {
        withFileParameter('THEFILE') {
          sh 'cat $THEFILE'
        }
      }
    }
  }
}

2. 执行前检查文件是否为空（允许不传文件但跳过操作） #

如果需要支持可选传入文件的场景，可以在 withFileParameter 块内先检查临时文件是否为空，为空则跳过后续命令：

pipeline {
  agent any
  parameters {
    base64File 'THEFILE'
  }
  stages {
    stage('Example') {
      steps {
        withFileParameter('THEFILE') {
          script {
            def fileSize = new File(env.THEFILE).size()
            if (fileSize > 0) {
              sh 'cat $THEFILE'
            } else {
              echo '未传入有效文件，跳过cat操作'
            }
          }
        }
      }
    }
  }
}

3. 前置参数校验（自定义报错逻辑） #

在流水线启动阶段添加参数校验步骤，手动判断文件参数是否有效，无效则终止流水线并抛出自定义错误：

pipeline {
  agent any
  parameters {
    base64File 'THEFILE'
  }
  stages {
    stage('参数校验') {
      steps {
        script {
          // 检查参数是否为空（base64格式的空文件会是短字符串）
          if (params.THEFILE?.trim().isEmpty()) {
            error '必须传入有效的文件参数'
          }
        }
      }
    }
    stage('Example') {
      steps {
        withFileParameter('THEFILE') {
          sh 'cat $THEFILE'
        }
      }
    }
  }
}

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