我太懂你在声明式流水线里用File Parameter碰到空指针的糟心了——这个参数类型确实在声明式里有兼容性bug，尤其是Jenkins版本偏老的时候，反而自由风格能正常跑。别慌，下面给你几个亲测有效的替代方案，都能实现上传任意格式（xls、properties啥的都行）文件到Jenkins工作区的需求：

方案1：用input步骤自带的文件上传（最推荐，官方支持） #

声明式流水线里的input步骤自带文件上传能力，稳定性拉满，还能在流水线运行时弹出交互界面让你上传文件。直接上代码示例：

pipeline {
    agent any
    stages {
        stage('上传文件到工作区') {
            steps {
                script {
                    // 弹出上传界面，获取用户上传的文件
                    def uploadedTempFile = input(
                        message: '请上传需要处理的文件',
                        parameters: [file(name: 'targetFile', description: '支持xls、properties等任意格式')]
                    )
                    // 把临时上传的文件复制到当前工作区
                    copy file: uploadedTempFile, to: "./${uploadedTempFile.name}"
                }
            }
        }
        stage('处理文件') {
            steps {
                echo "文件已成功上传到工作区：${pwd()}/targetFile"
                // 这里可以加你的业务逻辑，比如读取properties解析、处理xls表格
            }
        }
    }
}

这个方案的好处是完全贴合Jenkins声明式的语法，不会有兼容性问题，手动上传的体验也和自由风格差不多。

方案2：用httpRequest插件实现自动化上传（适合外部系统触发） #

如果你的需求是让外部系统（比如脚本、其他服务）自动上传文件，而不是手动在Jenkins界面操作，可以试试HTTP Request Plugin：

1. 先在Jenkins插件市场安装HTTP Request Plugin
2. 流水线示例代码（外部调用端的逻辑也可以参考）：

pipeline {
    agent any
    stages {
        stage('接收外部上传的文件') {
            steps {
                script {
                    def uploadResponse = httpRequest(
                        url: "http://你的Jenkins地址/job/${JOB_NAME}/buildWithParameters",
                        method: 'POST',
                        contentType: 'multipart/form-data',
                        requestBody: [
                            // 这里可以替换成你要上传的本地文件路径
                            uploadFile: file('/本地路径/test.xls'),
                            // 其他需要传递的参数也可以加在这里
                            env: 'test'
                        ]
                    )
                    echo "文件上传结果：${uploadResponse.status}"
                }
            }
        }
    }
}

这个方案适合自动化场景，比如CI/CD流程里自动上传配置文件。

方案3：从代理节点复制文件（适合文件已在节点上的场景） #

如果你的文件已经存放在Jenkins代理节点的某个目录下，不需要上传，直接复制到工作区就行，可以用字符串参数指定路径：

pipeline {
    agent any
    parameters {
        string(name: 'FILE_ABSOLUTE_PATH', description: '输入代理节点上文件的绝对路径，比如/opt/configs/app.properties')
    }
    stages {
        stage('复制文件到工作区') {
            steps {
                ws("${WORKSPACE}") {
                    sh "cp ${params.FILE_ABSOLUTE_PATH} ./"
                }
            }
        }
    }
}

这个方案比较小众，但适合文件已经在代理节点上的特定场景。

另外提一句：你碰到的空指针问题，大多是因为老版本Jenkins的声明式流水线对File Parameter的上下文初始化有问题，升级Jenkins到2.300以上版本可能会修复，但如果不想升级，上面的方案都能完美替代。

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