Azure DevOps Pipeline报错：找不到版本高于2.220.0的代理

问题原因说明 #

这种情况大概率是Azure DevOps服务端自动更新导致的——微软会定期升级Azure DevOps服务组件，部分底层依赖或新功能会自动对代理版本设置最低阈值，即便你未修改流水线配置，服务端也可能新增了Agent.Version的隐式需求。

解决思路选项 #

1. 强制流水线使用现有代理版本（临时 workaround） #

可以通过在流水线中显式添加反向需求，覆盖默认的版本要求：

• 打开流水线编辑界面，在pool配置块中添加demands节点：

pool:
  name: Default
  demands:
    # 精确匹配当前代理版本
    - Agent.Version -equals 2.170.1

或者允许所有低于2.220.0的版本：

pool:
  name: Default
  demands:
    - Agent.Version -lt 2.220.0

注意：该方法仅能临时解决问题，后续Azure DevOps服务端升级可能带来更多高版本代理依赖，长期不推荐使用。

2. 更新代理至新版本（长期稳定方案） #

步骤1：下载最新代理安装包

登录Azure DevOps组织，进入项目设置 → 代理池 → 选中Default池，点击右上角的下载代理，选择对应操作系统的安装包。

步骤2：卸载旧代理（可选但推荐）

• Windows：停止Azure Pipelines Agent服务，执行config remove完成卸载
• Linux/macOS：执行./svc.sh stop停止服务，再执行./config.sh remove卸载

步骤3：安装并配置新代理

• 解压新代理安装包
• 运行配置脚本：Windows执行config.cmd，Linux/macOS执行./config.sh
• 按照提示输入组织URL、具有代理池管理权限的PAT、代理池名称（Default）、代理名称等信息
• 配置完成后启动服务：Windows设置服务自动启动并启动；Linux/macOS执行./svc.sh install和./svc.sh start

步骤4：验证并测试

回到Azure DevOps代理池页面，确认Default池中的代理版本已更新，随后重新运行流水线验证问题是否解决。

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