TFS 2013至2018本地升级后构建代理等待请求故障求助

我之前帮团队处理过好几次TFS升级后构建代理挂起的情况，给你列几个优先级高的排查步骤，你可以一步步来定位问题：

• 检查代理池与队列的绑定关系
  先确认你创建构建任务时选择的代理队列，是否和已安装的代理所在的池正确绑定。升级过程中偶尔会出现队列和池的关联失效，你可以进入TFS的「代理池」管理页面，查看目标队列对应的池内是否存在你的代理，避免代理被误分配到其他池。

• 验证代理功能标签与任务需求匹配
  如果你的构建任务指定了特定的需求标签（比如需要VS2017、Node.js这类工具标签），而代理没有配置对应的标签，任务就会一直处于等待状态。你可以进入代理的配置页面，查看「功能」列表，对比构建任务里的需求项；如果是默认任务未指定标签，也可以临时给代理添加一个default标签测试。

• 查看代理日志定位具体错误
  代理安装目录下的_diag文件夹里有详细的运行日志，比如Agent_*.log和Worker_*.log。打开最新的日志文件，重点关注有没有权限报错、网络连接失败、TFS服务器通信异常这类信息。
  另外，你可以在代理安装目录下运行命令：.\config.cmd run，手动启动代理并查看实时输出，快速定位代理本身的启动或通信问题。

• 确认TFS应用层构建服务状态
  登录TFS应用层服务器，检查「Team Foundation Build Service」服务是否正常运行。升级后该服务可能未正确启动，或者服务账户权限不足，导致无法将构建任务调度到代理。

• 刷新代理注册与数据库配置
  虽然你已经升级了数据库副本，但构建相关的配置（如队列定义、代理注册信息）可能未完全同步。你可以进入TFS管理控制台的「构建和发布」->「代理池」，选中目标代理后尝试「重新注册」（部分版本有该选项），或者刷新代理池的配置信息。

• 检查代理服务账户权限
  运行VSTS Agent服务的账户，需要具备TFS的「代理池管理员」或「构建服务账户」权限，同时要有代理工作目录（默认是代理安装目录下的_work文件夹）的读写权限。权限不足时，代理可能显示在线，但无法接收并执行任务。

建议先从查看代理日志开始，大部分这类问题都能在日志里找到明确的错误提示。如果排查中发现具体的报错信息，也可以补充出来，能更精准地解决问题。

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