Jenkins声明式流水线中PowerShell脚本未实际执行问题求助

我之前也碰到过类似的情况，声明式流水线和脚本式流水线在PowerShell步骤的处理上确实存在一些细微差异，结合你的场景，咱们可以从这几个方向排查和解决：

1. 先确认工作目录与脚本路径 #

声明式流水线的默认工作目录可能和你预期的不一致，导致相对路径找不到脚本。你可以先打印当前目录验证：

pipeline{
    agent{ label 'windows' }
    stages {
        stage("Preparing"){
            steps{
                script {
                    def currentDir = powershell(returnStdout: true, script: 'Get-Location').trim()
                    echo "当前工作目录：${currentDir}"
                    // 用绝对路径调用脚本，避免相对路径问题
                    powershell "& '${currentDir}/scripts/SetVersion.ps1' ${version}"
                }
            }
        }
    }
}

这里用&调用脚本是PowerShell的标准写法，尤其是当路径包含空格时必须这么做，声明式流水线对这种语法的要求比脚本式更严格。

2. 检查变量传递的正确性 #

如果$version是流水线的参数或者全局变量，要确保它在当前stage的作用域内可用。另外，为了避免参数解析问题，建议把变量用单引号包裹：

powershell "./scripts/SetVersion.ps1 '$version'"

如果version包含特殊字符，用双引号包裹也可以，但要注意Jenkins的字符串插值规则。

3. 解决PowerShell执行权限问题 #

Windows默认的PowerShell执行策略可能阻止脚本运行，你可以在调用时显式指定执行策略：

powershell "-ExecutionPolicy Bypass -File ./scripts/SetVersion.ps1 $version"

-ExecutionPolicy Bypass会临时跳过权限检查，非常适合CI/CD场景。

4. 验证脚本本身是否执行 #

有时候脚本确实执行了，但因为没有输出导致你以为没运行。可以在SetVersion.ps1开头添加日志：

Write-Host "=== 开始执行SetVersion脚本，版本参数：$args[0] ==="
# 你的脚本逻辑...

这样在Jenkins日志里就能看到脚本的启动信息，确认是否真的被调用了。

5. 捕获脚本执行错误 #

如果脚本执行出错但没抛出异常，声明式流水线可能会直接跳过，你可以开启错误捕获：

powershell(script: "./scripts/SetVersion.ps1 $version", returnStatus: true)

returnStatus: true会返回脚本的退出码，方便你判断是否执行成功。

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