Azure DevOps API报错TF401175：分支版本描述符无法解析求助

针对你遇到的TF401175错误，结合你的代码，整理几个必查的排查点和修正方案：

排查要点 #

• 分支名称大小写敏感：Azure DevOps Git对分支名称大小写严格区分，比如你传入main但实际分支是Main，就会触发这个错误。先确认传入的sourceBranch和targetBranch与仓库中实际分支名完全一致（包括大小写、斜杠分隔的路径）。
• GitVersionDescriptor的正确用法：当VersionType设为GitVersionType.Branch时，Version字段直接传分支名即可，不需要加refs/heads/前缀（API内部会自动处理前缀拼接）。如果你传入带前缀的分支名，反而会被识别为无效分支。
• 项目/仓库名准确性：检查代码中projectname和reponame变量是否完全匹配Azure DevOps中的项目名称、仓库名称（同样注意大小写和特殊字符）。
• PAT权限验证：确保你的PAT拥有**Code (Read)**权限，并且作用域覆盖当前项目（如果是项目集合级PAT则没问题，项目级PAT要确认对应项目）。

修正后的代码示例 #

调整GitVersionDescriptor的参数传递，同时增加参数验证步骤：

public async Task<GitCommitRef[]> GetCommits(string sourceBranch, string targetBranch)
{
    // 先验证分支参数非空，避免空值传递
    if (string.IsNullOrWhiteSpace(sourceBranch) || string.IsNullOrWhiteSpace(targetBranch))
    {
        throw new ArgumentNullException("分支名称不能为空");
    }

    VssConnection conn = new(new Uri(this._azureDevOpsUrl), new VssBasicCredential(string.Empty, pat));
    GitHttpClient client = conn.GetClient<GitHttpClient>();
    List<GitCommitRef> commits = [];

    try
    {
        List<GitCommitRef> res = await client.GetCommitsAsync(
            project: projectname,
            repositoryId: reponame,
            criteria: new GitQueryCommitsCriteria
            {
                ItemVersion = new GitVersionDescriptor
                {
                    VersionType = GitVersionType.Branch,
                    Version = sourceBranch.Trim() // 移除前后空格，避免意外空格导致的匹配失败
                },
                CompareVersion = new GitVersionDescriptor
                {
                    VersionType = GitVersionType.Branch,
                    Version = targetBranch.Trim()
                }
            });

        if (res != null)
        {
            commits.AddRange(res);
        }
    }
    catch (Exception ex)
    {
        ConsoleEx.Throw($"Error fetching commits: {ex.Message}");
    }

    return commits.ToArray();
}

额外验证步骤 #

1. 手动调用Azure DevOps REST API测试：用Postman或curl调用GET https://dev.azure.com/{org}/{project}/_apis/git/repositories/{repo}/commits?itemVersion=branch:{sourceBranch}&compareVersion=branch:{targetBranch}&api-version=7.1-preview.1，如果这个请求也报错，说明是参数或权限问题；如果成功，说明是SDK调用时的参数问题。
2. 检查分支是否存在于指定仓库：确认sourceBranch和targetBranch确实属于代码中指定的reponame仓库，而不是其他仓库的分支。

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