适用范围与准备

适用于git ls-remote或拉取远端时提示重定向相关错误,而浏览器可以打开仓库网页。本篇先做只读远端引用查询,不改远端地址、不推送,也不把网页登录页当成Git服务地址。

先区分原因

http.followRedirects的false禁止跟随,initial只跟随首次请求的跳转,true允许后续请求继续跳转。默认initial会以跳转后的URL作为后续请求基础;浏览器能登录不代表Git的协议端点和认证流程已经正确。

按顺序操作

  1. 确认原仓库URL来自可信项目入口,记录Git错误及跳转目标的域名。若目标是陌生域名或普通登录页面,先停在身份和地址核对,不用允许全部跳转来碰运气。
  2. 只查询相关配置的来源和值,避免打印整个Git配置中可能存在的认证信息。--get-urlmatch可核对当前URL实际适用的设置;查不到值只表示未显式配置。
  3. 对于已确认属于同一服务的正常入口迁移,用git -c http.followRedirects=initial ls-remote做单次只读对照。这个-c仅影响本次命令,不覆盖全局设置。
  4. 如果首次请求能跳转而后续仍被拒绝,保留请求阶段与目标信息交服务维护者;不要擅自把全局设置改成true,也不把凭据粘到重定向URL中。
  5. 查询成功后核对返回的是预期仓库引用;确需更新远端时再单独核实新地址及推送地址,不能因为网页HTTP 200就替换所有项目的remote。
macOS / Linux shell;域名为占位,替换为有权访问的测试目标;无需管理员权限
git config --show-origin --get-all http.followRedirects
git config --get-urlmatch http.followRedirects "https://example.com/team/repo.git"
git -c http.followRedirects=initial ls-remote --heads "https://example.com/team/repo.git"
观察项含义与下一步
false将重定向视为错误
initial仅跟随初始请求,默认值
true允许更广的跟随,不能代替地址核验

怎样确认有效

预期仓库的只读引用查询完成,且已知跳转链符合该服务说明,才证明本次Git访问恢复。收到登录页HTML或空响应即使网络成功,也不是有效的引用列表。

无效时恢复与下一步

单次-c设置随命令退出失效。若问题仍在,保留原remote,分别核对认证和服务URL;本篇不建议关闭TLS验证,也不修改凭据助手来解决未知跳转。