TFS 2018 Update 2中XAML构建控制器离线问题求助

我帮你梳理几个实用的排查和恢复思路，都是针对TFS 2018 Update 2 XAML控制器离线问题的常用方案：

1. 先检查XAML构建服务的基础状态 #

• 打开服务器的服务（运行services.msc），找到Visual Studio Team Foundation Build Service（注意这是XAML构建专属的服务，不是新的Build Agent服务）：
  • 如果服务未启动，右键选择「启动」；如果已经运行，尝试重启一次服务，很多离线问题能通过重启解决。
  • 还要确认服务的登录账户：该账户需要拥有TFS服务器的项目集合管理员权限，并且能正常访问TFS配置数据库和代码仓库。

2. 验证XAML控制器的配置正确性 #

• 打开TFS管理控制台，导航到「构建配置」→「XAML构建控制器」：
  • 选中离线的控制器，右键点击「属性」，检查服务器URL是否为TFS的完整有效地址（比如http://tfs-server:8080/tfs）。
  • 确认对应的代理池配置无误，池内的代理是否处于在线状态。
  • 若TFS更新后配置有变动，右键选择「注册控制器」，跟着向导完成重新关联操作。

3. 通过日志定位具体报错 #

• XAML构建服务的日志默认路径为C:\Program Files\Microsoft Team Foundation Server 16.0\Application Tier\Build\_logs（可根据你的实际安装路径调整），打开最新的日志文件，搜索Offline、Error、Exception这类关键词，找到具体的报错原因（比如数据库连接失败、权限不足、端口被占用等）。
• 也可以在服务器的「事件查看器」中，查看Application日志下的TFS相关报错，辅助定位问题根源。

4. 确认TFS更新后的功能配置 #

TFS 2018 Update 2虽支持XAML构建，但更新可能会重置部分配置：

• 进入TFS的项目集合设置，在「构建和发布」选项中确认XAML构建功能是否处于启用状态。
• 用Visual Studio 2017/2019客户端连接TFS，打开团队资源管理器的「构建」面板，右键点击离线控制器，选择「连接」尝试重新激活。

5. 手动重新注册XAML控制器 #

如果以上方法都无效，试试手动注册：

• 以管理员身份打开命令提示符，导航到TFS工具目录：

  cd C:\Program Files\Microsoft Team Foundation Server 16.0\Tools
  

• 运行注册命令（替换成你的TFS URL和控制器名称）：

  TfsBuild.exe registercontroller /server:http://tfs-server:8080/tfs /name:"你的XAML控制器名称" /description:"重新注册的控制器"
  

• 执行完成后回到TFS管理控制台，检查控制器状态是否恢复在线。

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