使用.NET 6 C#调用Azure DevOps REST API推送压缩文件夹至仓库遇问题

一、推送压缩包到Azure仓库的400错误修正 #

你的代码存在两个核心问题导致400错误：

1. refUpdates参数格式错误：Azure DevOps Push API要求refUpdates是包含name属性的对象数组，而非字符串。
2. path参数不合法：推送单个文件时，path必须指定具体文件名（比如./archive.zip），不能用./指向根目录。

修正后的代码：

// 复用HttpClient，避免频繁创建实例
using var httpClient = new HttpClient();
var fileContent = await httpClient.GetByteArrayAsync(folderZipUrl);
var fileBase64String = Convert.ToBase64String(fileContent);

var jsonObj = new
{
    refUpdates = new[] { new { name = "refs/heads/main" } },
    path = "./archive.zip", // 指定具体的压缩包文件名
    message = "Initial commit",
    content = fileBase64String
};
string json = JsonSerializer.Serialize(jsonObj);

baseUrl = $"{baseUrl}/pushes?api-version=6.0";
response = await httpclient.PostAsync(baseUrl, new StringContent(json, Encoding.UTF8, "application/json"));

// 建议添加错误日志，查看API返回的具体错误信息
if (!response.IsSuccessStatusCode)
{
    var errorDetails = await response.Content.ReadAsStringAsync();
    // 输出errorDetails定位具体问题
}

额外提示：如果需要推送整个文件夹（而非单个压缩包），Push API无法直接实现，你需要遍历文件夹内所有文件逐个调用API，或使用Git命令行/官方SDK完成批量提交。

二、仓库创建API返回字段缺失问题 #

1. 权限与API版本校验：确保调用的是文档指定的API版本（7.0），且请求凭证拥有仓库创建的完整权限（如Project Collection Administrator或Contributor权限）。
2. JSON序列化配置问题：若使用System.Text.Json反序列化返回结果，默认会忽略目标类中未定义的属性。解决方式：
   • 使用dynamic类型接收返回结果，直接访问所有字段；
   • 创建包含所需字段的DTO类，并配置序列化选项：

     var serializeOptions = new JsonSerializerOptions
     {
         PropertyNameCaseInsensitive = true,
         IncludeFields = true // 若返回结果包含字段而非属性
     };
     var repoResponse = JsonSerializer.Deserialize<RepositoryDto>(responseContent, serializeOptions);
     

   • 或改用Newtonsoft.Json（Json.NET），它默认保留所有未知属性。

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