Azure DevOps看板测试注释消失问题求助及修复建议

问题现象 #

• Kanban看板上的**测试注释（Test Annotations）**停止显示，部分通过「Tested By」链接关联测试用例、测试套件的工作项也无测试注释
• 开启「New Boards Hubs」后所有注释完全不显示，关闭该功能后仅部分测试注释缺失

已排查情况 #

• 2019年曾因循环链接（Circular links）出现同类问题，通过配置UI定位修复后恢复
• 本次已将同层级工作项的Parent/Child链接修正为Related链接，但问题仍未解决
• 微软开发者社区反馈无法复现该问题

正常显示示例 #

相关历史问题 #

• 2019年问题：Azure DevOps - Kanban Board - Test Case Bottle not always showing
• 2023年问题：Test Annotation on Kanban Board items are breaking all board item annotations (Test Bottle is missing)

修复建议 #

1. 排查跨层级循环链接
   除同层级外，检查跨层级工作项的链接关系（如父项的父项与子项的子项是否形成循环）。可通过创建工作项查询筛选：

   • 添加筛选条件：链接类型包含「Parent」「Child」「Tested By」，遍历查询结果确认是否存在A→B→C→A的循环链

2. 重新验证并重建测试关联

   • 确认关联的测试用例未被删除、处于有效状态，测试套件已包含对应测试用例
   • 删除现有「Tested By」链接，重新关联工作项与测试用例/套件，等待看板自动刷新

3. 清理缓存强制刷新

   • 浏览器端：清除缓存、Cookie，用无痕模式打开看板页面
   • 看板页面按Ctrl+F5强制刷新，或联系管理员重启看板服务（若有权限）

4. 检查看板与工作项配置

   • 进入看板设置→注释，确认「测试注释」功能处于启用状态
   • 在项目设置→工作项类型→布局中，验证关联的工作项类型（如用户故事）已配置测试注释组件

5. 通过API排查链接异常
   调用Azure DevOps的Work Item Tracking - Get Work Item API获取工作项详细链接数据，检查relations字段是否存在重复链接、无效ID等异常情况

6. 提交微软支持工单
   若以上方法无效，收集以下信息提交给微软支持：

   • 问题工作项、测试用例/套件的ID
   • 看板完整URL
   • 问题出现前后的操作记录
   • 浏览器控制台的报错日志（F12刷新页面后抓取）

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