VSTS扩展开发问题：调用queryByWiql无法获取指定团队工作项

我来帮你排查这个问题——我之前在开发Azure DevOps（原VSTS）扩展时也遇到过类似的情况，核心问题通常出在WIQL查询语句的范围限定，或者参数传递的匹配上。以下是具体的排查和解决步骤：

1. 确保WIQL语句明确限定了团队/项目范围 #

即使你在调用接口时传入了项目和团队参数，queryByWiql接口不会自动帮你过滤结果——WIQL查询本身才是决定返回范围的核心。如果你的WIQL没有指定团队和项目的筛选条件，它就会返回所有可见的未关闭工作项。

正确的WIQL示例： #

方式一：直接指定名称

SELECT [System.Id], [System.Title], [System.State]
FROM WorkItems
WHERE [System.State] <> 'Closed'
AND [System.TeamProject] = '你的项目名称'
AND [System.Team] = '你的目标团队名称'

方式二：使用参数化绑定（更灵活）

如果你想通过接口传入的参数动态筛选，可以在WIQL中使用@project和@team占位符，然后在请求体中绑定对应的值：

SELECT [System.Id], [System.Title], [System.State]
FROM WorkItems
WHERE [System.State] <> 'Closed'
AND [System.TeamProject] = @project
AND [System.Team] = @team

2. 确认参数传递的正确性 #

调用queryByWiql时，要确保请求体中的参数和WIQL的占位符对应，并且参数值是团队/项目的名称或ID（两种格式都支持）。示例请求体结构如下：

{
  "query": "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.State] <> 'Closed' AND [System.TeamProject] = @project AND [System.Team] = @team",
  "parameters": {
    "project": "你的项目名称",
    "team": "allteams[0].name对应的团队名称"
  }
}

注意：如果你的WIQL中没有使用@project/@team占位符，那么你传入的项目和团队参数会被接口忽略，这就是为什么你会收到所有范围的工作项。

3. 排查权限与上下文问题 #

• 确保你的扩展拥有访问目标团队工作项的权限（比如Work Item Read权限）
• 确认请求的上下文是正确的——如果你的扩展是在项目/团队页面加载的，上下文应该自动匹配，但如果是全局页面发起的请求，需要明确指定项目和团队参数

4. 简化查询进行测试 #

先写一个极简的WIQL（只保留团队和未关闭状态筛选），测试返回结果是否符合预期，确认没问题后再逐步添加其他查询条件，这样能快速定位是否是WIQL语句的问题。

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