使用VSTS NET6库编辑Git文件推送时遇TF401028错误求助

错误信息 #

Microsoft.VisualStudio.Services.Common.VssServiceException: TF401028: The reference 'refs/heads/workbench' has already been updated by another client, so you cannot update it. Please try again.

问题场景 #

使用VSTS .NET6库编辑Git仓库中的文件，每次操作都会触发上述冲突错误，更换其他分支后问题依旧。核心实现逻辑是通过SaveConfigurationFileRepository方法先获取待编辑文件的objectId，再用changeType=edit更新文件内容。

核心问题分析 #

这个错误本质是Git的并发提交冲突，代码里犯了一个关键错误：把单个文件的objectId当成了分支的旧提交ID（OldObjectId）。GitRefUpdate中的OldObjectId需要的是目标分支当前最新的commit哈希，而不是单个文件的哈希值。用文件的objectId去更新分支，必然会和分支实际的最新状态不匹配，触发冲突。

另外代码混用.Result同步调用和await异步调用，容易导致死锁，也需要修正。

修正方案 #

1. 获取分支最新的commit ID #

在创建GitRefUpdate之前，先获取目标分支的头部commit哈希，而非文件的objectId。

2. 统一使用异步调用 #

把所有.Result替换为await，避免异步同步混用导致的死锁问题。

3. （可选）添加重试逻辑 #

针对并发冲突场景，可以添加重试机制，失败后重新获取最新分支状态再提交。

修正后的代码 #

以下是修改后的核心方法及相关逻辑：

public async Task<int> SaveConfigurationFileRepository(string groupName, string appName, string fileName, string fileContent)
{
    // 创建Vss连接
    var connection = new VssConnection(new Uri(contextConfiguration?.Url), new VssBasicCredential("", contextConfiguration?.AppToken));

    using (var gitClient = connection.GetClient<GitHttpClient>())
    {
        // 获取仓库信息
        var gitRepository = await gitClient.GetRepositoryAsync(contextConfiguration?.ProjectName, contextConfiguration?.RepositoryName);
        var branchName = "workbench";
        var branchRef = $"refs/heads/{branchName}";
        var gitDes = new GitVersionDescriptor() { Version = branchName };

        // 获取待编辑的文件
        var gitItemToEdit = await gitClient.GetItemAsync(gitRepository.Id, $"{groupName}/{appName}/{fileName}", versionDescriptor: gitDes, includeContent: true);

        if (gitItemToEdit is not null)
        {
            // 获取分支最新的commit ID（关键修正点）
            var branchRefs = await gitClient.GetRefsAsync(gitRepository.Id, filter: branchRef);
            var latestBranchCommitId = branchRefs.FirstOrDefault()?.ObjectId;
            if (string.IsNullOrEmpty(latestBranchCommitId))
            {
                throw new InvalidOperationException("无法获取分支最新的commit ID");
            }

            // 创建提交对象
            var newCommit = GetCommitForFile(gitItemToEdit, $"{groupName}/{appName}/{fileName}", fileContent);

            // 创建RefUpdate，使用分支最新commit ID作为OldObjectId
            var refUpdate = new GitRefUpdate()
            {
                RepositoryId = gitRepository.Id,
                Name = branchRef,
                OldObjectId = latestBranchCommitId
            };

            var gitChangesToPush = new GitPush()
            {
                RefUpdates = new GitRefUpdate[] { refUpdate },
                Commits = new GitCommitRef[] { newCommit }
            };

            // 推送变更
            var gitPush = await gitClient.CreatePushAsync(gitChangesToPush, gitRepository.Id);
            return gitPush.PushId;
        }
    }
    return 0;
}

private GitCommitRef GetCommitForFile(GitItem gitItemToEdit, string fileName, string content)
{
    return new GitCommitRef
    {
        Comment = "Update configuration template",
        Changes = new GitChange[]
        {
            new GitChange
            {
                ChangeType = VersionControlChangeType.Edit,
                // 复用获取到的gitItemToEdit，确保路径和版本匹配
                Item = gitItemToEdit,
                NewContent = new ItemContent
                {
                    Content = content,
                    ContentType = ItemContentType.RawText
                }
            }
        }
    };
}

额外说明 #

• 若获取分支最新commit ID到提交的间隙，分支被其他客户端修改，仍可能触发冲突，可添加重试逻辑（比如用Polly库实现）。
• 原代码中ProjctName存在拼写错误（少了字母'e'），建议修正避免潜在问题。

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