Jenkins 拉取 Git 代码超时报错 timeout after 10 分钟如何处理

Jenkins 拉取 Git 代码超时报错通常由仓库过大或网络延迟导致，最直接的处理是在任务配置中增加 Git 插件的超时时间。适用场景为构建频繁超时的自由风格或 Pipeline 任务，风险边界是可能掩盖底层网络不稳定问题。

先说结论：修改 Jenkins 任务中 Git 插件的 Timeout 配置项，或优化构建节点的网络连通性。

快速处理思路

该问题主要通过 Jenkins 界面配置调整，无需命令行操作。进入任务配置页面，找到源码管理部分，展开 Git 高级选项，将 Timeout 值从默认值调大。若网络环境确实较差，建议同时检查构建节点到 Git 服务器的连通性。

默认超时设置无法适应大仓库或高延迟网络。Jenkins Git 插件为了防止任务无限挂起，设置了默认的超时阈值。当仓库体积较大、分支较多或网络波动时，拉取操作耗时超过该阈值就会触发报错。公开资料中没有看到可靠的量化数据说明具体多大仓库会触发，通常取决于网络带宽和服务器性能。

第一步，登录 Jenkins 管理界面，进入报错的具体任务页面，点击左侧「配置」。

第二步，滚动到「源码管理」部分，选择 Git，点击下方的「高级」按钮展开更多选项。

第三步，找到「Timeout」（超时）输入框，将默认数值改大，例如从 10 改为 20 或 30 分钟。

第四步，点击页面底部「保存」，返回任务首页点击「立即构建」。

回滚提醒：若调大超时后构建时间过长影响队列，需考虑优化仓库大小或更换网络线路，而非无限增加超时时间。

查看最新一次构建的「控制台输出」。搜索关键字「timeout」或「error」，确认不再出现 Git 拉取相关的超时报错。若构建成功完成且代码已检出，说明配置生效。若仍报错，检查是否为 SSH 密钥权限问题或 Git 服务器端限制。

一是凭证配置错误被误判为超时，若日志显示 Authentication failed，应检查 SSH Key 或账号密码。

二是全局配置与任务配置冲突，部分 Jenkins 版本支持全局 Git 配置，需确认任务级设置是否覆盖了全局设置。

三是大文件未清理，若仓库包含历史大文件，单纯增加超时可能无法解决，建议使用 git gc 或移除大文件。

不会影响。该配置仅对当前任务生效，其他任务保持原有设置。

有影响。SSH 通常比 HTTPS 更稳定，若 HTTPS 频繁超时，可尝试切换为 SSH 协议拉取代码。

可以但不推荐。可通过修改 Jenkins 启动参数或 Git 插件全局配置实现，但建议优先在任务级别按需调整。