PowerShell脚本本地正常运行，Azure Runbook中报400错误求助

一、PowerShell版本差异排查 #

• 先对比本地与Azure Runbook的PowerShell版本：本地执行$PSVersionTable.PSVersion，Runbook中添加同一句代码输出版本。
• 版本差异可能带来的问题：比如本地用5.1，Runbook用7.x，Invoke-WebRequest的默认参数、头部处理逻辑有细微区别。可以尝试直接用哈希表初始化头部（$headers = @{ApiKey='xxx'}）替代Add方法，避免集合操作的版本差异。

二、400错误核心排查方向 #

1. 请求头问题 #

• Azure Runbook环境对请求头的处理可能和本地不同，比如隐形编码差异。直接用哈希表定义头部，避免逐个Add的操作。
• 检查目标API是否要求其他必填头部（如User-Agent、Content-Type），本地环境可能自动补充了这些头部，但Runbook环境没有。手动添加测试：

  $headers = @{
      ApiKey='xxx'
      'User-Agent' = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36'
      'Content-Type' = 'application/json' # 按需调整
  }
  

2. 网络与权限限制 #

• Azure Runbook的执行服务器位于Azure数据中心，目标API的防火墙/白名单可能未允许Azure IP段访问。需要确认目标API的IP限制规则，将Runbook所在区域的Azure IP段加入白名单。
• 检查是否需要代理：本地可能使用了代理，而Runbook环境未配置，或者反之。可添加代理参数测试：

  $proxyParams = @{Proxy='http://your-proxy-address:port'}
  Invoke-WebRequest "https://myurl/Export/" -Headers $headers -Outfile $file @proxyParams
  

3. 请求内容与URL验证 #

• 确认Runbook中的URL完全正确，无拼写错误，部分API在公网与Azure内部的访问路径可能不同。
• 检查是否需要额外查询参数：本地可能因缓存或会话自动携带参数，但Runbook是无状态环境，需显式传递所有必要参数。

4. 捕获详细错误信息 #

• 在Runbook中添加错误捕获逻辑，获取API返回的具体错误内容，明确400的原因：

  try {
      Invoke-WebRequest "https://myurl/Export/" -Headers $headers -Outfile $file -ErrorAction Stop
  } catch {
      Write-Error "请求失败: $($_.Exception.Message)"
      Write-Output "响应详情: $($_.Exception.Response.Content.ReadAsStringAsync().Result)"
      Write-Output "响应头部: $($_.Exception.Response.Headers)"
  }
  

三、其他环境差异排查 #

• 本地可能存在已保存的凭据或会话，Runbook是全新环境，若API依赖Cookie或会话信息，需在请求中显式携带。
• 检查目标API的SSL证书是否被Azure环境信任：自签名证书在本地可能被信任，但Azure环境不认可，可临时添加-SkipCertificateCheck参数测试（生产环境禁用）：

  Invoke-WebRequest "https://myurl/Export/" -Headers $headers -Outfile $file -SkipCertificateCheck
  

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