使用azure-DevOps-migration-tools迁移Git仓库时GitRepoMapping不生效如何解决

以下为按优先级排序的排查解决方法：

• 检查配置语法与字符误差
  你当前配置中TargetProjectName末尾携带了多余空格，首先需删除该空格，确保键、值的名称完全匹配实际源、目标项目的名称，大小写也需保持完全一致。同时需校验整个JSON配置文件没有语法错误，比如引号未闭合、漏写逗号等问题，可先用JSON校验工具确认配置合法性。
• 检查配置节点层级是否正确
  GitRepoMapping属于Git仓库迁移处理器的专属配置项，不可直接放在全局配置根节点下，需放到GitRepoMigration类型的处理器配置块内才会生效，正确的配置结构参考如下：

  {
    "Processors": [
      {
        "ProcessorType": "GitRepoMigration",
        "GitRepoMapping": {
          "SourceProjectName": "TargetProjectName"
        }
        // 其余处理器参数省略
      }
    ]
    // 其余全局参数省略
  }
  

• 检查迁移账号权限是否足够
  确认你使用的迁移账号PAT（个人访问令牌）同时具备源项目Git仓库的读取权限、目标项目Git仓库的创建/写入权限，权限不足会导致映射匹配后无法在目标端执行操作，表现为配置不生效。
• 开启调试日志定位具体错误
  在配置文件的全局节点添加"LogLevel": "Debug"参数，重新运行迁移任务，查看日志中GitRepoMapping相关的匹配记录，可直接定位是源项目识别错误、目标项目不存在还是其他原因导致的匹配失败。
• 确认工具版本兼容性
  旧版本的迁移工具存在GitRepoMapping不生效的已知Bug，如果你使用的不是最新稳定版，可升级工具版本后重新测试配置。

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