Azure DevOps托管代理池任务停滞队列，状态异常求助

问题现象 #

• 使用Azure Pipelines托管代理池时，项目界面显示2个任务运行、70个任务排队，但进入代理池详情页后，所有任务仅显示白圈图标，无实际正在运行的任务
• 取消并删除所有任务后，点击任意任务会触发报错提示
• 已尝试提升管道管理权限、禁用/重新添加代理池等操作，均未解决
• 已知可能是Azure DevOps管道延迟Bug，但需快速恢复

快速修复步骤 #

1. 强制刷新状态缓存 #

打开Azure DevOps的组织设置 -> 代理池 -> 选中目标托管代理池，在页面按Ctrl+Shift+R强制刷新（跳过本地缓存），重复2-3次后查看任务状态是否恢复。

2. 用REST API清理异常队列 #

执行以下API请求清空异常任务队列（替换占位符为你的组织、项目和代理池信息）：

DELETE https://dev.azure.com/{组织名}/{项目名}/_apis/distributedtask/pools/{代理池ID}/jobs?api-version=7.1-preview.1

• 代理池ID可从代理池详情页的URL中提取（如.../pools/123/agents中的123）
• 确保执行请求的账号拥有代理池管理员权限，可通过Postman或Azure DevOps CLI操作。

3. 临时切换代理池 #

若当前使用的是通用Azure Pipelines托管池，临时切换到特定版本的托管池（如Azure Pipelines - Windows 2022），重新触发管道任务，待任务正常运行后再切回原代理池。

4. 提交官方支持工单 #

若以上方法均无效，直接在Azure DevOps右上角点击问号图标 -> 报告问题，提交支持工单时提供以下信息加速排查：

• 组织ID、项目ID、代理池ID
• 任务异常的时间范围
• 已执行操作的截图及结果描述

内容的提问来源于stack exchange，提问作者A.Sevi