Azure DevOps构建API分页查询（$top/$skip）失效问题求助

嘿，我之前也踩过Azure DevOps API分页的坑，来帮你分析下可能的原因和解决办法！

首先明确：Azure DevOps的Build API确实支持$top和$skip分页，你用的7.1-preview.7版本也没问题，所以肯定是某个细节没做对。

先排查最容易踩的几个坑： #

1. 检查请求URL是否正确传递了参数
   有时候axios在手动拼接URL时，可能会把$符号意外转义成%24，导致API识别不了$skip参数。你可以先把最终的URL打印出来验证：

   const skipNumber = 10;
   const returnNumber = 25;
   const url = `https://dev.azure.com/name/${projectName}/_apis/build/builds?api-version=7.1-preview.7&$top=${returnNumber}&$skip=${skipNumber}`;
   console.log('实际请求URL:', url);
   const response = await axios.get(url, { headers });
   

   如果打印出的URL里$skip变成了%24skip，推荐改用axios的params选项传递参数，避免手动拼接的转义问题：

   const response = await axios.get(`https://dev.azure.com/name/${projectName}/_apis/build/builds`, {
     headers: headers,
     params: {
       'api-version': '7.1-preview.7',
       '$top': returnNumber,
       '$skip': skipNumber
     }
   });
   

   用params传递时，axios会自动处理参数编码，确保$符号正确传递给API。

2. 确认排序规则稳定
   Azure DevOps Build API默认按buildId降序返回最新构建，但如果有构建的创建时间完全相同，可能导致排序不稳定，看起来分页结果重复。建议手动指定排序参数，保证分页一致性：

   params: {
     'api-version': '7.1-preview.7',
     '$top': returnNumber,
     '$skip': skipNumber,
     'orderBy': 'buildId desc'
   }
   

3. 检查构建总数是否足够
   你可以查看响应里的totalCount字段，确认项目里的构建总数是否大于$top + $skip：

   console.log('总构建数:', response.data.totalCount);
   console.log('当前返回数量:', response.data.count);
   

   如果totalCount小于25+10=35，那返回的就是剩余的所有构建，看起来像是“只返回前25条”，但实际是数据量不足导致的。

4. 备用方案：用continuationToken分页
   如果以上方法都不行，可以试试Azure DevOps推荐的continuationToken分页方式，这种方式在数据量很大时更可靠：

   • 第一次请求不带continuationToken，获取第一页数据和响应里的continuationToken
   • 后续请求把这个token作为参数传递，就能拿到下一页数据
     示例代码：

   let continuationToken = null;
   do {
     const response = await axios.get(`https://dev.azure.com/name/${projectName}/_apis/build/builds`, {
       headers: headers,
       params: {
         'api-version': '7.1-preview.7',
         '$top': returnNumber,
         'continuationToken': continuationToken
       }
     });
     // 处理当前页数据
     console.log('当前页构建:', response.data.value);
     // 更新continuationToken，为空则停止循环
     continuationToken = response.data.continuationToken;
   } while (continuationToken);
   

另外你提到的limit和offset是其他API的参数，Azure DevOps不支持，所以不用再试啦。

备注：内容来源于stack exchange，提问作者user22722316