使用azure-devops-migration-tools v11.9.20.0迁移AZDO工作项报InvalidOperationException:序列含多元素
错误根源定位
从错误堆栈直接定位核心触发逻辑:
System.InvalidOperationException: Sequence contains more than one element at System.Linq.Enumerable.Single[TSource](IEnumerable`1 source) at MigrationTools.Enrichers.TfsNodeStructure.ProcessCommonStructure(...)
- 报错位置调用了 LINQ
Single()方法:该方法强制要求查询返回的序列必须恰好包含1个元素,一旦返回2个及以上匹配结果,就会抛出当前异常 - 触发环节:日志显示流程已执行到
Migrating all Nodes before the Processor run,也就是工具在正式迁移工作项前,自动同步AZDO项目**区域路径(Area)、迭代路径(Iteration)**等结构节点的阶段
实际触发原因
结合11.9.20版本工具的逻辑特性,以及你已经手动配置好源/目标一致方法论结构的前提:
该版本的节点匹配逻辑仅按节点末级名称查询目标项目的对应节点,未校验完整路径,当目标项目中存在满足以下条件的节点时,查询就会返回多个匹配结果触发异常:
- 节点类型相同(同为Area 或同为Iteration)
- 节点末级名称相同,但挂载在不同的父路径下
(例如两个分别挂在「产品A」「产品B」父节点下的「前端」区域、两个不同父级下的「Sprint 1」迭代)
排查与解决步骤
- 第一步:检查目标AZDO项目的区域、迭代路径结构,删除或重命名所有「同类型下末级名称重复」的节点
- 第二步:如果目标节点结构确实已经完全匹配源项目要求,可在迁移配置文件中找到节点同步相关配置,将其
Enabled属性设为false,直接跳过工具的自动节点同步流程 - 第三步:如果上述操作仍报错,说明是11.9.20旧版本的已知匹配逻辑缺陷,可升级工具至修复了该问题的后续稳定版本,或在配置中手动指定节点路径映射规则,替代工具的自动匹配逻辑
内容的提问来源于stack exchange,提问作者Artkanoid
相关产品推荐
相关产品推荐

