Jenkins字符串参数MOV为何为空？已设默认值仍无法读取

我来帮你排查下这个问题，这种参数为空的情况通常是配置或者脚本语法的小问题，咱们一步步来：

• 先确认参数配置的正确性
  首先回到任务的配置页面，检查「General」标签下是否已经勾选了「This project is parameterized」，然后确认添加的是String Parameter，参数名称严格是MOV（Jenkins参数名区分大小写，别写成小写mov或者混合大小写了），并且默认值确实设置为5。如果配置里参数名写错了，那脚本里自然拿不到值。

• 检查构建时的参数传递
  如果是手动触发构建，一定要确认在构建启动页面能看到MOV的输入框，并且你没有清空它（保留默认值5或者手动输入都可以）。如果是通过API、其他工具触发构建，要确保请求里明确带上了MOV=5的参数，否则Jenkins会用空值覆盖默认值。

• 脚本执行环境的语法问题
  分两种情况看：

  1. 如果是在「Execute shell」步骤中执行命令：
     • 别用单引号包裹变量！shell里单引号会阻止变量解析，echo '${MOV}'只会输出字符串${MOV}，而不是参数值。正确的写法是echo "${MOV}"或者echo $MOV。
     • 也可以试试直接打印所有环境变量，用env | grep MOV看看这个变量是否存在，能快速定位是不是变量根本没传到shell环境里。
  2. 如果是用Jenkins Pipeline脚本（Jenkinsfile）：
     • 声明式Pipeline里要通过params.MOV来引用参数，比如：

       pipeline {
           agent any
           parameters {
               string(name: 'MOV', defaultValue: '5', description: '测试参数')
           }
           stages {
               stage('测试参数') {
                   steps {
                       // 两种写法都可以
                       sh 'echo ${MOV}'
                       sh "echo ${params.MOV}"
                   }
               }
           }
       }
       

     • 脚本式Pipeline则可以用env.MOV或者params.MOV直接获取。

• 排查参数是否被意外覆盖
  检查任务中在执行echo "${MOV}"之前的步骤，有没有其他脚本或者插件操作清空了这个变量，比如有没有执行unset MOV这样的shell命令，或者某些插件修改了环境变量。

• 查看系统日志找线索
  如果以上都没问题，去Jenkins的「Manage Jenkins」->「System Log」里搜索MOV相关的日志，看看有没有参数解析失败、变量注入出错的提示，能帮你定位更隐蔽的问题。

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