Azure DevOps REST API导入请求返回400错误排查求助

DevOps 小满

2026-7-28

Azure DevOps仓库导入API返回400 Bad Request的排查与修复

一、立即修复脚本中的语法错误

你的导入请求JSON体存在明显笔误，@{n是无效语法，这会导致生成的JSON格式完全错误，直接触发400请求失败。

错误代码段：

$bodyImportRepo = @{
  parameters=@{n
    gitSource=@{n
      url=$sourceRepoUrl
    }
  }
} | ConvertTo-Json

修复后代码：

$bodyImportRepo = @{
  parameters=@{
    gitSource=@{
      url=$sourceRepoUrl
    }
  }
} | ConvertTo-Json -Depth 10

注意：必须添加-Depth 10参数，避免PowerShell默认的2层深度限制截断嵌套的JSON结构

二、其他排查方向

如果修复语法后仍报错，按以下步骤逐一验证：

检查PAT权限：确保你的个人访问令牌（PAT）同时拥有：
- 源项目的代码(读取)权限
- 目标项目的代码(写入)权限
  权限不足会伪装成400错误，可在Azure DevOps的PAT管理页面确认权限范围。
验证源仓库可访问性：确认目标环境能正常访问源仓库URL，若源是私有Azure DevOps仓库，需确保当前PAT有权限访问源项目。
添加创建延迟：仓库创建API返回成功后，后台可能存在同步延迟，建议在创建仓库和发起导入请求之间加短暂等待：
```
Start-Sleep -Seconds 5
```

获取详细错误响应：400错误的响应体通常包含具体原因，用try-catch捕获完整错误信息：

try {
    Invoke-RestMethod -Uri "https://dev.azure.com/$organization/$project/_apis/git/repositories/$repoName/importRequests?api-version=7.0" -Method Post -ContentType "application/json" -Headers $headers -Body $bodyImportRepo -Verbose
} catch {
    $errorStream = $_.Exception.Response.GetResponseStream()
    $reader = New-Object System.IO.StreamReader($errorStream)
    $reader.BaseStream.Position = 0
    $reader.DiscardBufferedData()
    $detailedError = $reader.ReadToEnd()
    Write-Host "详细错误内容:" $detailedError
}

输出的内容会明确指出是参数错误、权限问题还是格式问题。