通过REST API导入GitLab仓库到Azure DevOps时遇400错误求助

核心排查与修复步骤 #

1. 修正导入请求的URL结构 #

你的导入URL使用了/repositories/{REPO_NAME}/importRequests，但这个端点仅适用于向已存在的Azure DevOps仓库导入内容。如果目标仓库尚未创建，需使用不带具体仓库名的端点：

import_url = f"https://dev.azure.com/{ORG_NAME}/{PROJECT}/_apis/git/repositories/importRequests?api-version=7.1-preview.1"

若目标仓库已存在，需将overwrite设为True（同时确保PAT拥有仓库修改权限），否则会触发400错误。

2. 修复GitLab仓库URL格式 #

你提到的https://gitlab.example.com/.git是无效的仓库地址，正确格式必须包含群组和仓库名称，例如：

GITLAB_REPO_URL = "https://gitlab.example.com/my-group/my-target-repo.git"

缺失仓库路径会导致Azure DevOps无法定位源仓库，直接返回400。

3. 验证服务连接配置的正确性 #

创建服务连接的payload存在两处关键问题：

• url字段错误：服务连接的url应填写GitLab服务器根地址（如https://gitlab.example.com），而非具体仓库的URL；
• 认证参数匹配：GitLab的HTTPS认证需使用任意非空用户名（如git）+ 个人访问令牌作为密码，修正后的认证配置如下：

  "authorization": {
      "scheme": "UsernamePassword",
      "parameters": {
          "username": "git",  # GitLab仅验证password字段，此处可填任意非空值
          "password": "{GitLab个人访问令牌}"
      }
  }
  

  注意确保使用的是GitLab生成的、具有仓库读取权限的令牌，而非GitHub令牌。

4. 补充导入请求的必填字段 #

根据Azure DevOps API规范，导入请求的import_payload需包含顶层type字段，修正后的结构：

import_payload = {
    "type": "git",  # 新增此字段指定导入类型
    "parameters": {
        "gitSource": {
            "url": GITLAB_REPO_URL,
            "overwrite": False,
        },
        "serviceEndpointId": connection_id,
        "deleteServiceEndpointAfterImportIsDone": True
    }
}

5. 获取详细错误信息定位问题 #

400错误的具体原因可通过打印响应JSON内容获取，添加以下代码查看详细描述：

print(import_response.json())

Azure DevOps会返回如字段缺失、权限不足、URL无效等具体提示，这是快速定位问题的核心方法。

6. 尝试稳定版API #

虽然你使用了7.1-preview.1，建议切换到稳定版API（如7.0），部分预览版端点可能存在兼容性问题：

import_url = f"https://dev.azure.com/{ORG_NAME}/{PROJECT}/_apis/git/repositories/importRequests?api-version=7.0"

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