运行Azure DevOps迁移工具报路径未锚定无法创建错误咨询

报错原始日志 #

[12:39:29 INF] Migrating all Nodes before the Processor run.
[12:39:30 INF] Processing Node: \Streamlined\Area\ Inventory\ Management\MMS Upgrade UAT, start date: null, finish date: null
[12:39:30 FTL] Error while running WorkItemMigration
System.InvalidOperationException: Path \Streamlined\Area\ Inventory\ Management\MMS Upgrade UAT is not anchored in the target project, it cannot be created.
at MigrationTools.Enrichers.TfsNodeStructure.GetOrCreateNode(String nodePath, Nullable1 startDate, Nullable1 finishDate) in D:\a\1\s\src\MigrationTools.Clients.AzureDevops.ObjectModel\ProcessorEnrichers\TfsNodeStructure.cs:line 157

具体触发原因 #

该错误由TfsNodeStructure节点结构处理器抛出，工具内置校验规则要求：所有需要在目标项目创建的区域路径、迭代路径，必须从目标项目已经存在的根节点开始逐层向下生成，找不到匹配的根锚点时就会直接阻断迁移，常见触发场景如下：

• 路径根前缀不匹配：日志中待创建的路径根前缀为\Streamlined\Area\，如果目标项目的名称不是Streamlined，且迁移配置中没有添加路径映射规则将源端根路径替换为目标项目的对应根路径，工具就无法找到可挂载的根锚点。
• 源端路径存在格式异常：日志里的路径段 Inventory前带有多余的前置空格，属于源端路径的不规范字符，即便目标项目已经存在同名的Inventory Management节点，带额外空格的路径也无法匹配到已有的锚点节点。
• 迁移配置缺失必要规则：WorkItemMigration工作项迁移处理器绑定的TfsNodeStructure扩展器没有配置节点自动创建规则，也没有提前在目标项目手动创建对应层级的路径，工具不支持直接生成无挂载根的完整路径。

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