如何在Jenkins PowerShell步骤中调用Web API解决超时匹配问题

方案1：修正现有请求参数，修复异常阻塞问题 #

首先明确：TimeoutSec参数定义的是最长等待时间，而非固定阻塞时长，正常情况下服务端返回响应后请求会立刻结束。如果你设置大值后会固定阻塞10小时，大概率是服务端没有正确返回结束标识、或者连接保持逻辑异常，可先调整请求参数修复：

• 禁用HTTP保持连接，添加-ConnectionTimeout 180 -DisableKeepAlive参数，避免无效长连接占用
• 超时参数设为略大于你的服务最长运行时长即可，比如服务最长运行8小时就设-TimeoutSec 28800，无需设置冗余过大的数值

方案2：改用异步轮询模式（更稳定，适合超长耗时任务） #

这是工业界处理超长耗时API调用的标准方案，如果可以对服务端做小幅度调整，推荐优先使用该方案：

1. 调整服务端逻辑：收到任务触发请求后立刻返回唯一任务ID，无需等待任务执行完成，这一步的TimeoutSec设30秒足够
2. 新增任务状态查询接口，支持通过任务ID查询任务当前运行状态
3. PowerShell侧写循环轮询状态接口，检测到任务结束后立刻退出Jenkins步骤

对应PowerShell示例代码 #

try
{ 
    # 触发任务，获取任务ID
    $triggerUrl = "https://ourserver.com/modules/OurService/trigger"
    $triggerResponse = Invoke-WebRequest -Uri $triggerUrl -UseDefaultCredentials -Method Post -TimeoutSec 30 -UseBasicParsing
    $taskId = ($triggerResponse.Content | ConvertFrom-Json).taskId

    # 轮询任务状态，每分钟查询一次
    $statusUrl = "https://ourserver.com/modules/OurService/status?taskId=$taskId"
    do {
        Start-Sleep -Seconds 60
        $statusResponse = Invoke-WebRequest -Uri $statusUrl -UseDefaultCredentials -Method Get -TimeoutSec 30 -UseBasicParsing
        $taskStatus = ($statusResponse.Content | ConvertFrom-Json).status
    } while ($taskStatus -eq 'running')

    # 处理最终执行结果
    if ($taskStatus -eq 'success') {
        Write-Host "任务执行成功"
        exit 0
    } else {
        Write-Host "任务执行失败"
        exit -1
    }
}
catch 
{    
    $err=$_.Exception  
    Write-Host '-----------------------'
    Write-Host $err        
    Write-Host '-----------------------'  
    exit -1
}

方案3：无法修改服务端时使用替代请求工具 #

如果服务端逻辑完全无法调整，可以用curl命令替代Invoke-WebRequest，其超时逻辑和原生PowerShell cmdlet不同，不会出现固定阻塞的问题：

curl --url "https://ourserver.com/modules/OurService" --ntlm --max-time 36000

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