JGIT在Kubernetes环境推送空提交过慢问题求助

1. 存储层权限与性能瓶颈 #

出现的.git/refs/remotes/origin/.probe-xxx: Operation not permitted错误，是JGit在检测文件系统属性时触发的权限问题。K8s环境中如果使用网络存储卷（如NFS、EFS），本身IO延迟就比本地存储高，再加上权限限制，会导致JGit在本地仓库预处理阶段耗时剧增。

• 排查：检查Pod挂载的PVC存储类型，换成低延迟的本地SSD卷测试；确认Pod对Git仓库目录（包括.git子目录）拥有完整的读写权限。
• 修复：在代码中禁用JGit的文件权限探测，避免不必要的系统调用：

  // 在初始化仓库后添加
  RepositoryConfig config = myGitFolder.getRepository().getConfig();
  config.setBoolean(CoreConfig.CONFIG_CORE_SECTION, null, CoreConfig.KEY_FILEMODE, false);
  config.save();
  

2. 网络传输与超时配置问题 #

K8s环境的网络策略、代理或防火墙可能对Push流量做了限流，而JGit默认的超时设置不足以应对。另外，TCP连接在K8s网络中如果长期闲置，可能被中间节点断开，导致JGit重试拖慢流程。

• 排查：检查K8s网络策略是否允许Pod访问Git远程仓库的端口（HTTPS 443/SSH 22）；测试Pod到Git服务器的网络延迟（用curl或telnet）。
• 修复：
  • 显式设置Push超时时间：

    Iterable<PushResult> prList = myGitFolder.push()
            .setRemote("origin")
            .setCredentialsProvider(credentialsProvider)
            .setTimeout(10) // 单位：秒
            .call();
    

  • 配置TCP Keep-Alive避免连接被断开：

    Transport transport = myGitFolder.getTransport("origin");
    transport.setTimeout(10000); // 10秒超时
    transport.setCredentialsProvider(credentialsProvider);
    // 开启TCP Keep-Alive
    if (transport instanceof HttpTransport) {
        ((HttpTransport) transport).getHttpConnectionFactory().setTimeout(10000);
    }
    Iterable<PushResult> prList = transport.push();
    transport.close();
    

3. 本地仓库状态异常 #

如果K8s环境中多个Pod共享同一个Git仓库（比如挂载了同一个PVC），会导致仓库出现锁冲突、松散对象堆积，JGit在Push前需要额外的时间处理这些状态。空提交虽然没有数据传输，但本地仓库的校验流程仍会耗时。

• 排查：检查是否有多个Pod同时操作同一仓库；查看.git目录下是否有*.lock锁文件残留。
• 修复：
  • 每个Pod使用独立的本地仓库（比如用emptyDir临时存储），避免共享存储的冲突。
  • 在Push前执行仓库垃圾回收，清理冗余对象：

    myGitFolder.gc().setAggressive(true).call();
    

4. JGit版本已知问题 #

JGit 6.5版本在容器/网络存储环境下可能存在文件系统探测的性能bug，导致不必要的延迟。

• 排查：查看JGit官方的issue列表，确认是否有相关的性能问题报告。
• 修复：升级JGit到最新稳定版本（如6.7.x及以上），或降级到6.4.x版本测试是否解决问题。

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