如何解决Jenkins克隆Unreal Engine仓库时的各类报错？

一、处理Git克隆时的网络与大文件报错 #

你遇到的RPC failed、early EOF、sideband packet断开这类报错，都是大仓库克隆时的网络限制或Git配置不足导致的，试试这些调整：

• 增大Git的HTTP缓存和缓冲区：在Jenkins任务里加一个前置执行步骤（Linux用Execute shell，Windows用Execute Windows batch command），执行以下命令：

  git config --global http.postBuffer 524288000
  git config --global http.maxRequestBuffer 100M
  git config --global core.compression 0
  

  增大缓冲区能减少传输中断概率，关闭压缩可降低服务器和客户端的计算压力。
• 用浅克隆（如果业务允许）：在Jenkins的Git模块里勾选「Shallow clone」，设置Depth为1，只克隆最新提交。如果后续需要完整历史，再手动拉取就行，能大幅减少UE4仓库的传输量。
• 拆分克隆任务：先克隆不含大文件的轻量版本，再按需拉取内容：

  git clone --filter=blob-none https://你的仓库地址.git
  cd 仓库目录
  git checkout 4.26
  git sparse-checkout set Content/你需要的子目录  # 只拉取必要的大文件目录
  

• 切换克隆协议：如果之前用HTTPS，换成SSH协议试试，SSH的长连接稳定性比HTTPS更好，适合大文件传输。

二、解决Jenkins Git模块「Failed to connect to repo」问题 #

已经调过超时和凭证还报错，试试这些操作：

• 升级Git客户端：过旧的Git版本可能和仓库协议不兼容，把Jenkins服务器上的Git升级到2.30以上，然后在Jenkins的「Global Tool Configuration」里指定新版本的Git路径。
• 手动验证凭证：在Jenkins服务器上用相同凭证手动克隆仓库，比如：

  # HTTPS凭证验证
  git clone https://用户名:密码@你的仓库地址.git
  # SSH凭证验证
  git clone git@你的仓库地址.git
  

  如果手动克隆也失败，说明是凭证或网络路由的问题，和Jenkins配置无关。
• 检查代理配置：如果Jenkins走代理访问仓库，确认「Manage Jenkins」→「Manage Plugins」→「Advanced」里的代理配置正确，同时给Git也配置相同代理：git config --global http.proxy http://代理IP:端口。
• 重置Git插件：卸载Git插件，删除Jenkins插件目录（JENKINS_HOME/plugins）下的git相关文件，再重新安装最新版的Git插件，有时候缓存会导致连接异常。

三、解决「FATAL: Java heap space」报错 #

这是Jenkins的Java堆内存不够，处理大仓库克隆时内存溢出：

• 修改Jenkins启动参数：找到Jenkins的启动配置文件（Linux是/etc/default/jenkins，Windows是jenkins.xml），调整JAVA_ARGS的堆内存参数：

  JAVA_ARGS="-Xmx4g -Xms2g"  # 把最大堆内存设为4G，初始堆内存设为2G，可根据服务器配置调整
  

• 重启Jenkins服务，让新的内存配置生效。

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