Jenkins Slave节点使用CURL下载Zip文件时创建文件失败

看起来你在Jenkins Slave上用Groovy执行curl下载时遇到了文件创建失败的问题，我之前也碰到过类似情况，大概率是路径、权限或者命令执行方式的问题，给你几个排查和修复的方向：

1. 先确认输出目录存在且有权限 #

你的curl命令里用了<output-dir>，如果这个目录不存在，curl肯定没法创建文件；另外Jenkins Slave的运行用户（一般是jenkins或者你配置的专用用户）得有这个目录的写入权限才行。

建议在下载前先主动创建目录，修改代码如下：

script {
    def outputDir = "<你的实际输出目录，比如/opt/downloads>"
    def url = "<server url>"
    
    // 先创建目录（-p参数确保父目录不存在也能创建）
    sh "mkdir -p ${outputDir}"
    
    // 注意要指定完整的文件路径，比如outputDir/lwbs.zip，避免curl不知道把文件放哪
    def processDownload = ['bash', '-c', "curl -g -k --noproxy \"*\" -o ${outputDir}/lwbs.zip \"${url}\""].execute()
    processDownload.waitFor()
    
    // 一定要打印curl的输出和错误日志，这是排查的关键！
    println "CURL执行输出: ${processDownload.in.text}"
    println "CURL错误信息: ${processDownload.err.text}"
    
    // 解压时也要指定完整路径，避免找不到zip文件
    def processUnzip = ['bash', '-c', "7z e ${outputDir}/lwbs.zip -o${outputDir}"].execute()
    processUnzip.waitFor()
    println "解压输出: ${processUnzip.in.text}"
}

2. 换成Jenkins内置的sh步骤更靠谱 #

直接用.execute()执行数组形式的bash命令，有时候会遇到变量替换、环境变量加载不全的问题，不如用Jenkins原生的sh步骤，它会自动处理这些细节，而且命令失败时会直接标记阶段失败，方便你定位问题：

pipeline { 
    agent { label '<my slave label>' } 
    stage('Download & Unzip') { 
        steps { 
            script { 
                def url = "<server url>"
                def outputDir = "<你的实际输出目录>"
                
                // 用多行shell脚本更清晰，还能一次性执行多个命令
                sh """
                    set -e  # 命令失败时立即退出
                    mkdir -p ${outputDir}
                    # 添加-v参数可以打印curl的详细请求日志，方便排查下载问题
                    curl -v -g -k --noproxy "*" -o ${outputDir}/lwbs.zip "${url}"
                    7z e ${outputDir}/lwbs.zip -o${outputDir}
                """
            }
        }
    }
}

3. 手动在Slave上验证命令 #

如果还是不行，建议你登录到Jenkins Slave机器，切换到Jenkins运行用户（比如su - jenkins），手动执行相同的curl命令，看是否能成功创建文件。如果手动执行也失败，那就是Slave机器本身的问题（比如权限不足、网络不通）；如果手动能成功，那就是Pipeline里的命令有变量替换或者环境的问题。

4. 检查curl参数的细节 #

• 确保<output-dir>是绝对路径，相对路径可能会因为Jenkins的工作目录（workspace）变化而找不到位置
• 确认${url}里的特殊字符（比如空格、&）都被正确包裹在引号里，避免命令被截断
• 如果目标服务器需要认证，别忘了加-u username:password或者对应的token参数

按照这些步骤排查，应该能很快找到问题所在。

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