Jenkins Git Parameter插件无法加载GitLab标签，请求排查

问题描述 #

• 配置了Git Parameter插件（参数名TAG），用于拉取GitLab仓库所有标签，默认值设为v1.0.0，同时搭配其他选择、字符串参数供构建脚本使用
• 触发「带参数构建」时，标签下拉框持续处于加载状态，超时后报错（界面显示加载失败）
• 对比环境：两台EC2实例Jenkins版本均为2.346.1，插件完全一致，仅操作系统不同——故障实例为Ubuntu 16.04，正常实例为Arch
• 已将故障实例Git版本从2.7升级至2.34.1（与正常实例一致），问题仍未解决；目前仅能使用默认标签发起构建
• 额外现象：构建初始阶段的Git仓库操作日志输出极慢，需4分钟才能在控制台显示；但手动在工作区执行Git命令可正常列出标签

排查与解决步骤 #

1. 验证Jenkins用户的仓库访问速度 #

切换到Jenkins运行用户（通常为jenkins），执行以下命令观察耗时：

git ls-remote --tags <你的GitLab仓库地址>

• 如果命令执行超时或耗时过长，说明是Jenkins用户访问GitLab的网络问题，可尝试：
  • 更换仓库地址为SSH协议（若之前用HTTPS），确认Jenkins用户的SSH密钥已正确配置并授权GitLab访问
  • 检查EC2实例的网络出口，是否存在防火墙、代理限制，或GitLab仓库所在网络的连通性问题
  • 将GitLab服务器IP手动添加到/etc/hosts，绕过DNS解析延迟

2. 调整插件超时设置 #

• 进入Jenkins全局配置，找到Git Parameter插件的设置项，延长标签拉取的超时时间（部分版本需在插件专属配置页调整）
• 若全局无对应设置，可尝试在Job的参数配置中，添加自定义超时参数（部分插件版本支持在参数配置里指定超时值）

3. 修复Ubuntu 16.04系统依赖问题 #

Ubuntu 16.04系统库较旧，可能与新版Git、Jenkins插件存在兼容性问题：

• 重装并更新证书，避免SSL验证延迟：

  sudo apt update && sudo apt install --reinstall ca-certificates
  

• 临时关闭Git SSL验证测试（测试后建议恢复并配置正确证书）：

  git config --global http.sslVerify false
  

• 升级系统curl依赖库：

  sudo apt install libcurl4-gnutls-dev
  

4. 清理Jenkins Git缓存 #

• 进入Jenkins「系统管理」→「管理文件」，清理Git相关缓存目录（如cache下的仓库缓存）
• 手动删除对应Job工作区的.git目录，触发构建时重新拉取仓库，避免缓存损坏

5. 调整系统资源限制 #

Ubuntu 16.04可能因资源限制导致插件请求超时：

• 修改Jenkins启动参数，增加线程池与内存配置，编辑/etc/default/jenkins：

  JAVA_ARGS="-Xmx2g -XX:MaxPermSize=512m -Djenkins.model.Jenkins.slavesThreadPoolSize=100"
  

• 提高系统文件句柄限制，编辑/etc/security/limits.conf：

  jenkins soft nofile 65535
  jenkins hard nofile 65535
  

• 重启Jenkins服务：

  sudo systemctl restart jenkins
  

6. 调整插件版本（谨慎操作） #

尽管两台机器插件版本一致，但不同系统的运行环境可能存在差异：可尝试将故障实例的Git Parameter插件降级到前一个稳定版本，或升级到最新兼容版本（操作前建议备份Job配置）

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