Azure Pipeline中PowerShell任务调用接口返回502 Bad Gateway故障排查

你遇到的问题是：Azure Pipeline内联PowerShell任务中，第二次POST请求返回502 Bad Gateway错误，但本地PowerShell和Postman执行相同请求完全正常。结合日志和场景，以下是针对性的排查和解决方法：

1. 验证请求URL的正确性 #

第一次请求成功后，返回的$myId可能存在格式问题（比如包含特殊字符、大小写不一致），导致拼接后的URL不符合API要求。

• 在脚本中添加日志输出，确认$myId和最终请求URL：

$myId=$firstResponse.Id
Write-Host "First request returned ID: $myId"
$secondUrl = "URL/$myId"
Write-Host "Second request URL: $secondUrl"
# 后续请求改用$secondUrl
$secondResponse = Invoke-RestMethod -Method POST -ContentType application/json `
-Uri $secondUrl `
-Headers $Headers `
-Body $secondBody `
-TimeoutSec 180

对比输出的URL和Postman中使用的URL，确保完全一致。

2. 增加两次请求的间隔时间 #

第一次请求创建资源后，后端可能需要时间完成初始化，Pipeline环境下网络或后端处理延迟可能导致第二次请求时资源尚未就绪，触发网关错误。

• 在获取$myId后增加等待时间：

$myId=$firstResponse.Id
Start-Sleep -Seconds 10 # 根据实际情况调整时长

3. 统一请求的User-Agent头 #

日志显示请求的User-Agent包含多个条目，部分API对User-Agent格式有严格校验，与Postman的User-Agent不一致可能导致请求被拦截。

• 在Headers中手动设置与Postman一致的User-Agent：

$Headers = @{
    "Authorization" = "Bearer $(tokenVar)"
    "User-Agent" = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36"
}

4. 优化TLS协议配置 #

当前的TLS协议设置包含旧版本，可能与Azure代理或目标API的TLS兼容性存在问题。

• 强制使用TLS 1.2：

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

5. 获取更详细的错误响应内容 #

502错误的具体原因可能隐藏在响应体中，当前日志未捕获这部分信息。

• 修改catch块，读取并输出响应体：

catch {
    Write-Host "An exception was caught: $($_.Exception.Message)"
    if ($_.Exception.Response) {
        $responseStream = $_.Exception.Response.GetResponseStream()
        $streamReader = New-Object System.IO.StreamReader($responseStream)
        $responseBody = $streamReader.ReadToEnd()
        Write-Host "Full response body: $responseBody"
        $_.Exception.Response | Format-List * | Out-String | Write-Host
    }
    $counter++
    Start-Sleep -s 5
}

通过响应体中的具体信息，可以进一步定位网关错误的根源（比如后端服务超时、路由配置问题等）。

6. 检查Pipeline代理的网络限制 #

Azure Pipeline代理的网络环境与本地不同，可能存在防火墙规则、IP白名单限制：

• 确认目标API是否允许Azure数据中心的IP访问，如有需要，将Azure代理IP段加入API的白名单。
• 在Pipeline任务中添加网络连通性测试：

Test-NetConnection -ComputerName "xxx.xxx.com" -Port 443

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