Git报错unable to update local ref：无法更新本地引用求助

错误原因 #

这个错误的核心是Git引用路径冲突：

• 本地已存在标签 4.3.1.136，对应本地文件 .git/refs/tags/4.3.1.136
• 远程新增了标签 4.3.1.136/artifactory，Git 需要创建 .git/refs/tags/4.3.1.136 目录来存储这个子标签，但该路径已经是一个文件，无法创建目录，因此报错。

这个问题和凭证无关，你之前删除.gitconfig中凭证的操作对解决该问题没有帮助。

解决方案 #

1. 清理本地冲突标签 #

执行以下命令检查并删除本地的4.3.1.136标签：

# 确认本地是否存在该标签
git tag -l "4.3.1.136"
# 如果存在，删除本地标签
git tag -d 4.3.1.136

2. 尝试重新拉取 #

删除本地标签后，执行git fetch或git pull，如果远程只存在4.3.1.136/artifactory标签，此时应该能正常拉取。

3. 远程同时存在两个冲突标签的处理（需维护者配合） #

如果远程仓库同时存在4.3.1.136和4.3.1.136/artifactory两个标签，Git无法同时处理这两个引用，必须让仓库维护者删除其中一个冲突的标签。

4. 临时绕过方案（无需修改远程） #

如果暂时无法修改远程仓库，可配置Git在fetch时排除这两个冲突标签：

# 重置origin的fetch规则，只拉取分支
git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"
# 添加排除规则，忽略冲突的两个标签
git config --add remote.origin.fetch "^refs/tags/4.3.1.136"
git config --add remote.origin.fetch "^refs/tags/4.3.1.136/artifactory"

配置完成后，git fetch、git pull以及rebase操作都不会再触发该错误。

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