Jenkins执行Groovy脚本无法检出RepoTwo仓库问题排查

针对你遇到的Jenkins无法通过Groovy脚本里的GitSCM克隆RepoTwo（报错Git LFS文件下载失败、仓库未找到），且已验证SSH Key手动可用的情况，可尝试以下排查和解决步骤：

1. 核对Groovy脚本中GitSCM的核心配置 #

• 确认RepoTwo的SSH URL准确性：GitHub仓库名区分大小写，检查脚本中RepoTwo的URL是否与手动克隆时完全一致（包括组织名、仓库名的大小写、后缀），避免因拼写错误导致"仓库未找到"。
• 指定对应RepoTwo的凭证ID：若RepoTwo和RepoOne属于不同GitHub服务器，必须确保脚本中userRemoteConfigs的credentialsId是对应RepoTwo服务器的SSH凭证ID，而非RepoOne的。示例配置：

checkout([
    $class: 'GitSCM',
    branches: [[name: '*/main']],
    userRemoteConfigs: [[
        url: 'git@github.com:your-org/RepoTwo.git',
        credentialsId: 'repo-two-ssh-key' // 替换为RepoTwo的SSH凭证ID
    ]],
    extensions: [[$class: 'GitLFSPull']] // 必须添加该扩展拉取LFS文件
])

2. 检查Jenkins节点的Git LFS环境 #

• 确认节点已安装Git LFS：在Jenkins执行构建的节点（master/agent）上运行git lfs version，若未安装则先完成安装，并在Jenkins全局工具配置中指定包含LFS的Git路径。
• 验证Jenkins用户的SSH环境：Jenkins默认以jenkins用户运行，需确保该用户的~/.ssh目录下有RepoTwo对应的私钥（权限设为600），且公钥已添加至RepoTwo的GitHub仓库权限列表。可在构建步骤中添加shell命令ssh -T git@github.com（替换为RepoTwo的GitHub服务器地址）验证连接有效性。

3. 完善GitSCM的LFS相关配置 #

• 强制拉取LFS文件：GitSCM默认不会自动拉取LFS对象，必须在extensions中添加GitLFSPull扩展，否则会出现"LFS文件下载失败"报错。
• 延长克隆超时时间：若RepoTwo的LFS文件体积较大，可添加CloneOption扩展设置超时时间，避免因超时中断拉取：

extensions: [
    [$class: 'GitLFSPull'],
    [$class: 'CloneOption', timeout: 60] // 超时时间设为60分钟，按需调整
]

4. 排查GitHub仓库端的LFS权限与状态 #

• 确认LFS对象存在性：登录GitHub查看RepoTwo的LFS文件状态，确保未被误删除；手动克隆后执行git lfs pull，验证LFS文件可正常拉取。
• 检查仓库权限：确认Jenkins所用SSH Key对应的GitHub账号，拥有RepoTwo的读取权限（包括LFS对象的访问权限），部分场景下仓库读取权限与LFS权限需单独配置。

5. 调试定位具体问题 #

在Groovy脚本中添加调试步骤，输出关键信息辅助排查：

sh 'git config --list' // 查看Git全局配置
sh 'ssh -v git@github.com' // 输出SSH连接详细日志
sh 'git lfs env' // 查看Git LFS环境配置

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