VSO WorkItem API查询无结果，原有PowerShell脚本突然失效求助

嘿，这种之前稳得一批突然掉链子的情况真的闹心——毕竟跑了好几个月都没毛病对吧？我来帮你捋捋可能的原因和解决办法：

先把你提到的查询代码片段整理出来，方便后续分析：

# Get current work items.
$workitemsUrl = "https://" + $instance + "/DefaultCollection/" + $project + "/_apis/wit/wiql?api-version=1.0"
# ... 后续执行请求的代码

下面是几个最可能的元凶和对应的排查/修复步骤：

• API版本过时导致兼容性问题
  你用的api-version=1.0是相当老旧的版本了，Azure DevOps/VSO的API最近可能对旧版本做了废弃或者规则调整。建议先升级到当前主流的稳定版本，比如api-version=7.1，修改URL部分：

  $workitemsUrl = "https://" + $instance + "/DefaultCollection/" + $project + "/_apis/wit/wiql?api-version=7.1"
  

  另外要注意：如果你的VSO环境最近升级到了新版Azure DevOps，DefaultCollection可能已经被替换成组织名，URL结构会变成https://dev.azure.com/{organization}/{project}/_apis/wit/wiql?api-version=7.1，这个路径变化大概率是常见的失效原因。

• 身份验证方式失效
  之前的脚本用的身份验证可能突然失效了：

  • 检查个人访问令牌(PAT)是否过期：如果用PAT登录，去Azure DevOps/VSO的组织设置里看看你的PAT是不是刚好最近到期，重新生成一个拥有WIT读写权限的PAT替换进去。
  • 确认认证头是否正确：PowerShell请求里的Authorization头不能错，用PAT的话应该是这样：

    $headers = @{ Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$PAT")) }
    Invoke-RestMethod -Uri $workitemsUrl -Headers $headers -Method Post -Body $wiqlQuery -ContentType "application/json"
    

    记住PAT前面的冒号绝对不能丢，而且必须用ASCII编码。

• WiQL查询语法的隐性变更
  虽然你的WiQL之前正常，但Azure DevOps可能悄悄调整了查询规则：

  • 先把你的WiQL复制到Azure DevOps的Web端去执行，看看能不能正常返回结果——如果Web端都跑不通，那就是查询本身的问题，比如自定义字段引用名改了、查询限制收紧了，得调整语法。

• 网络/环境变量变更

  • 检查脚本运行的机器是不是换了网络环境？比如公司防火墙新增了对Azure DevOps域名的拦截，或者代理设置变了。可以用这个命令测试连通性：

    Test-NetConnection -ComputerName ($instance) -Port 443
    

  • 确认$instance和$project变量有没有被误修改，比如实例名拼写错了、项目重命名了，这些小细节很容易被忽略。

最后，建议你给脚本加个错误捕获，拿到具体的错误信息会更快定位问题：

try {
    $response = Invoke-RestMethod -Uri $workitemsUrl -Headers $headers -Method Post -Body $wiqlQuery -ContentType "application/json" -ErrorAction Stop
} catch {
    Write-Host "Error details:"
    Write-Host "Status code: $($_.Exception.Response.StatusCode.value__)"
    Write-Host "Error message: $($_.Exception.Message)"
    $reader = New-Object System.IO.StreamReader($_.Exception.Response.GetResponseStream())
    $responseBody = $reader.ReadToEnd()
    Write-Host "Response body: $responseBody"
}

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