适用范围与准备
适用于Git通过HTTP或HTTPS获取远端时,明确出现传输速度过低或类似超时提示。先记录完整错误和正在执行的命令;SSH远端不由这组HTTP配置控制。
先区分原因
http.lowSpeedLimit以每秒字节数设置低速门槛,http.lowSpeedTime设置允许低于门槛持续多少秒。达到条件时Git中止传输,并不是服务器主动宣布不可用。GIT_HTTP_LOW_SPEED_LIMIT和GIT_HTTP_LOW_SPEED_TIME环境变量还能覆盖配置。
按顺序操作
- 确认远端使用HTTP或HTTPS,记录失败发生在初始查询还是大对象传输阶段。保留已有工作区,不因下载中断删除仓库或覆盖未提交文件。
- 只查询这两个配置的值和来源,检查是否继承了适用于另一网络的高门槛。查不到值不是错误根因已确认,还需查看当前进程的对应环境变量。
- 检查代理路径和服务状态,避免把根本没有数据的断连误认为正常低速。若配置门槛明显不适合当前受控测试,可在单次git -c命令中使用更宽容但仍有限的等待。
- 下方只读ls-remote示例采用1字节/秒、30秒作演示,不是性能建议;它只能验证小型引用请求,不能代替大对象下载验收。确认没有环境覆盖后再运行,必要时用Ctrl+C停止。
- 需要验证原下载时,在保留本地改动的前提下按原流程重试一次,分别记录是否仍因低速门槛中止、实际耗时及对象取得情况。不要把无限等待设置作为永久修复。
git config --show-origin --get-all http.lowSpeedLimit
git config --show-origin --get-all http.lowSpeedTime
git -c http.lowSpeedLimit=1 -c http.lowSpeedTime=30 ls-remote --heads "https://example.com/team/repo.git"| 观察项 | 含义与下一步 |
|---|---|
| lowSpeedLimit | 每秒字节门槛 |
| lowSpeedTime | 持续低于门槛的秒数 |
| 环境变量 | 可能覆盖配置,需单独检查 |
怎样确认有效
原失败路径完成且内容可用,或能够明确证明是门槛触发并给出有限等待后的真实结果,才有结论。只读引用查询成功不能证明克隆或LFS对象传输也已完成。
无效时恢复与下一步
单次-c配置随命令结束失效;恢复自己临时调整过的环境变量。若宽容门槛下仍没有进展,继续定位网络或服务端,不反复增大时间掩盖持续断流。