Jenkinsfile中函数返回CRON表达式遇空指针异常的问题排查

问题现象 #

根据环境（Development、Test、Prod）在Jenkinsfile的triggers块选择对应CRON表达式时，触发空指针异常：

hudson.remoting.ProxyException: java.lang.NullPointerException: Cannot invoke "String.split(String)" because "format" is null

核心流水线代码：

pipeline {
    agent any
    triggers{
        cron( cronExpression = getCronParams() )
    }
...

对应的函数代码：

def getCronParams() {
    withFolderProperties {
        echo "Environment is ${env.ENVIRONMENT}"
        switch ("${env.ENVIRONMENT}") {
            case 'Development':
               echo "Applying Development Area Configuration..."
                return "@midnight"
            case 'Production':
                echo "Applying Production Configuration..."
                return "@midnight"
            default:
                echo "Unknown Environment, unable to handle Environment appropriately, will exit here..."
                break
        }
    }
}

注：使用Jenkins Folder Properties插件设置环境变量，运行日志显示环境变量已正确识别，但异常依然存在；即使修改switch确保所有分支返回@midnight，问题仍未解决。

原因分析 #

1. triggers块执行时机冲突：Jenkins声明式流水线中，triggers属于初始化阶段执行的代码，这个阶段会在agent启动前、所有流水线步骤（包括withFolderProperties）运行前就执行。而withFolderProperties是需要在流水线运行阶段（agent启动后）才能生效的步骤，所以初始化阶段调用getCronParams()时，withFolderProperties内部的逻辑根本没执行，函数没有返回值，默认返回null，导致cron表达式为空触发异常。
2. 函数返回值缺失：即使环境变量识别正常，原函数的default分支没有返回值；但核心问题还是执行时机——withFolderProperties在初始化阶段不生效，函数内部的switch逻辑完全没跑，直接跳出后函数无返回值，最终返回null。

解决方案 #

方案1：改用脚本式properties设置触发器（推荐） #

把触发器逻辑移到流水线外部的properties步骤中，该步骤会在运行阶段执行，能正确获取withFolderProperties的环境变量：

pipeline {
    agent any
    stages {
        // 你的业务阶段逻辑
    }
}

// 用脚本式逻辑设置流水线触发器
properties([
    pipelineTriggers([
        cron(getCronParams())
    ])
])

def getCronParams() {
    withFolderProperties {
        echo "Environment is ${env.ENVIRONMENT}"
        switch ("${env.ENVIRONMENT}") {
            case 'Development':
               echo "Applying Development Area Configuration..."
                return "@midnight"
            case 'Production':
                echo "Applying Production Configuration..."
                return "@midnight"
            case 'Test':
                echo "Applying Test Area Configuration..."
                return "H 10 * * *" // 自定义Test环境的CRON表达式
            default:
                echo "Unknown Environment, using default CRON..."
                return "@daily"
        }
    }
}

方案2：直接读取环境变量（若支持初始化阶段访问） #

如果Folder Properties设置的环境变量能在初始化阶段被读取到（部分插件配置场景下可行），可以去掉withFolderProperties，直接读取env.ENVIRONMENT：

def getCronParams() {
    echo "Environment is ${env.ENVIRONMENT}"
    switch ("${env.ENVIRONMENT}") {
        case 'Development':
           echo "Applying Development Area Configuration..."
            return "@midnight"
        case 'Production':
            echo "Applying Production Configuration..."
            return "@midnight"
        case 'Test':
            echo "Applying Test Area Configuration..."
            return "H 10 * * *"
        default:
            echo "Unknown Environment, using default CRON..."
            return "@daily"
    }
}

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