Git拉取正常但推送失败（本地TFS仓库VPN下401错误）

这种情况确实挺让人挠头的——能正常拉取代码，之前也能推送，现在却卡在HTTP 401认证失败，说明基础的网络连通和读取权限是没问题的，但推送环节的认证或权限逻辑出了问题。我给你梳理几个排查方向和解决办法：

1. 先排查Git凭据缓存的问题 #

Git经常会缓存旧的认证凭据，拉取操作可能还能复用缓存的有效凭据，但推送时需要重新验证却失败了：

• 清除Git全局的凭据助手配置，让Git重新提示你输入账号密码：

  git config --global --unset credential.helper
  

  如果是Windows系统，还可以打开凭据管理器，找到对应TFS仓库的存储凭据，删除后再尝试推送，这时候Git会弹出认证窗口让你重新输入。
• 如果你用的是TFS个人访问令牌（PAT），检查令牌是否过期，或者权限是否被修改。重新生成一个包含「Code (Push)」或「Code (Full)」权限的PAT，然后更新远程仓库地址：

  git remote set-url origin https://<你的PAT>@<TFS仓库地址>
  

2. 检查TFS端的权限设置 #

拉取正常说明你有读取权限，但推送失败大概率是权限被限制了：

• 登录TFS Web界面，找到目标仓库，进入「设置」→「权限」，确认你的账号是否拥有「Contribute」权限（这个权限包含推送代码的权限）。
• 还要检查分支级别的权限：比如主分支（main/master）可能被设置了保护规则，需要通过PR合并，或者只有特定用户组才能直接推送，你的账号不在允许范围内。
• 另外，确认最近是否有TFS服务更新，或者你的账号被移出了项目相关的用户组。

3. 排查VPN和网络层面的异常 #

虽然拉取正常，但推送的请求可能走了不同的网络路径，或者VPN防火墙有特殊限制：

• 先试试在VPN环境下，通过TFS网页端直接提交代码（比如编辑一个文件然后保存提交）。如果网页端也提交失败，那问题肯定出在TFS服务或权限上；如果网页端能提交，那就是Git客户端的配置问题。
• 有些VPN会限制HTTP POST请求的大小（哪怕你的推送只有90KB，也不排除有奇怪的规则），可以问问VPN管理员是否有相关限制。

4. 检查Git的其他配置项 #

除了http.postBuffer，还有几个配置可能影响推送的认证流程：

• 检查是否设置了过期的http.extraHeader：

  git config --global --get http.extraHeader
  

  如果有输出，尝试清除这个配置：

  git config --global --unset http.extraHeader
  

• 开启Git的调试模式，查看更详细的认证日志，能帮你定位具体哪里出错：

  GIT_CURL_VERBOSE=1 git push
  

  这个命令会输出curl的完整请求细节，比如是否发送了正确的凭据，TFS返回401的具体原因是什么。

5. 重置远程仓库连接 #

有时候远程仓库的配置会出现异常，试试重新添加远程：

git remote remove origin
git remote add origin <你的TFS仓库地址>

之后重新输入凭据尝试推送。

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