Jenkins Windows节点向Linux服务器SCP传输时环境变量使用问题

这个问题我碰到过好几次，大概率是变量解析或路径格式的坑导致的，咱们一步步排查解决：

1. Groovy字符串插值的引号误区 #

Jenkins Pipeline基于Groovy语法，字符串引号的类型直接决定了${env.WORKSPACE}会不会被解析成真实路径：

• 如果用单引号'，${env.WORKSPACE}会被当作纯文本字符串原样传递，SCP会去寻找字面量为${env.WORKSPACE}/build/libs/ssupservice-0.0.1-SNAPSHOT.jar的文件，肯定找不到。
• 必须用双引号"，才能让Groovy自动把变量替换成实际的工作目录路径。

错误示例： #

sh 'scp ${env.WORKSPACE}/build/libs/ssupservice-0.0.1-SNAPSHOT.jar user@linux-server:/target/path'

正确示例： #

sh "scp ${env.WORKSPACE}/build/libs/ssupservice-0.0.1-SNAPSHOT.jar user@linux-server:/target/path"

2. Windows路径的斜杠兼容问题 #

Windows从节点的env.WORKSPACE返回的是Windows风格路径（比如C:\Jenkins\workspace\MyJob），直接拼接正斜杠会出现混合路径（C:\Jenkins\workspace\MyJob/build/libs/...），部分SCP客户端无法识别这种格式。

有两个简单的解决办法：

办法A：把反斜杠替换为正斜杠 #

用Groovy的字符串替换方法统一路径分隔符：

def posixWorkspace = env.WORKSPACE.replace('\\', '/')
sh "scp ${posixWorkspace}/build/libs/ssupservice-0.0.1-SNAPSHOT.jar user@linux-server:/target/path"

办法B：用pwd()方法自动适配路径 #

Jenkins内置的pwd()方法会根据执行环境自动返回适配的路径，在Windows节点的sh步骤中会直接输出POSIX风格路径：

sh "scp ${pwd()}/build/libs/ssupservice-0.0.1-SNAPSHOT.jar user@linux-server:/target/path"

3. 节点上下文的变量作用域问题 #

如果你的Pipeline没有明确指定在Windows从节点上执行变量获取和SCP操作，env.WORKSPACE可能取到的是Jenkins主节点（可能是Linux）的工作目录，而非Windows从节点的真实路径。

一定要确保步骤在Windows agent下执行：

pipeline {
    agent { label 'windows-slave' } // 指定你的Windows从节点标签
    stages {
        stage('Transfer File via SCP') {
            steps {
                script {
                    def posixWorkspace = env.WORKSPACE.replace('\\', '/')
                    sh "scp ${posixWorkspace}/build/libs/ssupservice-0.0.1-SNAPSHOT.jar user@linux-server:/target/path"
                }
            }
        }
    }
}

额外验证小技巧 #

如果还是有问题，可以先打印出实际路径确认是否正确：

echo "原始工作目录路径：${env.WORKSPACE}"
echo "转换后路径：${env.WORKSPACE.replace('\\', '/')}/build/libs/ssupservice-0.0.1-SNAPSHOT.jar"

查看Jenkins日志，确认输出的路径和你之前用的绝对路径是否一致。

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