使用VSTS REST API跨项目导入Git仓库遇400错误求排查思路

我来帮你梳理下这个400错误的常见排查方向，毕竟Azure DevOps（原VSTS）的REST API返回400通常是请求参数、结构或者权限相关的问题，结合你给出的脚本参数，这些点可以重点检查：

1. 核心参数的完整性与格式校验 #

• 你的$SourceGit参数看起来没写完，务必确保它是完整的源仓库URL——不管是Azure DevOps内部仓库（比如https://dev.azure.com/{OrgA}/ProjectA/_git/RepoA）还是外部仓库（比如GitHub的https://github.com/username/repo.git），格式不能有多余空格、拼写错误或者截断。
• 检查$collectionUri的格式：必须是目标组织的完整集合URL，比如https://dev.azure.com/YourOrg或旧版的https://YourAccount.visualstudio.com，末尾不要加多余的斜杠。
• 确认$TargetTeamProject和$TargetGitRepoName完全匹配目标环境中的名称——Azure DevOps对名称是区分大小写的，比如"MyProject"和"myproject"会被视为不同项目。

2. 请求体的结构正确性 #

虽然你没贴出请求体的具体内容，但创建导入请求的API要求严格的JSON结构。举个内部仓库导入的正确示例：

{
  "sourceGitUrl": "https://dev.azure.com/OrgA/ProjectA/_git/RepoA",
  "targetRepository": {
    "name": "TargetRepoName",
    "project": {
      "id": "目标项目的GUID"
    }
  }
}

• 要确保字段名完全正确（比如不能把sourceGitUrl写成sourceUrl），没有语法错误（缺失逗号、引号不匹配都会直接导致400）。如果是外部仓库导入，还需要额外的serviceEndpointId等字段。

3. 令牌权限与格式 #

• 你的$token（PAT个人访问令牌）需要足够的权限：源仓库要有读取权限，目标项目要有仓库创建/写入权限。创建PAT时要勾选Code (Read & Write)或Code (Full)的范围，并且确保令牌对应的账号能访问源和目标项目。
• 验证令牌的携带格式：在PowerShell中调用API时，要把PAT转成Basic认证格式，比如：

  $headers = @{
    "Authorization" = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$token"))
  }
  

  注意冒号不能丢，这是很多人容易犯的错误。

4. API版本的指定 #

调用Azure DevOps API必须指定正确的api-version参数，导入仓库的API至少需要api-version=5.1（更高版本也兼容）。如果没指定版本或者版本过低，也可能返回400错误。

5. 特殊字符编码问题 #

如果参数中包含空格、&、#这类特殊字符，要确保已经正确URL编码。比如在PowerShell中可以用[Uri]::EscapeDataString()处理仓库名称或项目名称，避免编码错误导致请求被拒绝。

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