Jenkins Docker容器内git lfs pull执行失败问题求助

问题分析 #

报错batch request: executable file not found in $PATH并非指git-lfs本身未安装（你已验证git lfs version正常输出），而是Git LFS执行批量拉取时调用的辅助程序无法在PATH中找到，或Git未正确关联LFS处理规则；同时HTTPS仓库的认证配置缺失也可能导致拉取失败。

解决方案 #

1. 修正Dockerfile的Git LFS配置 #

修改Dockerfile，确保系统级Git LFS配置生效并保证PATH完整性：

FROM eclipse-temurin:21.0.4_7-jdk-alpine
RUN apk update && apk add --no-cache git git-lfs \
    && git lfs install --system \
    && echo "export PATH=\$PATH:/usr/bin" >> /etc/profile

• git lfs install --system：在系统级别配置Git LFS，确保所有用户会话都能识别LFS规则
• 显式追加PATH到系统配置，避免容器内环境变量缺失问题

2. 调整Jenkinsfile的认证与拉取逻辑 #

默认Jenkins的SCM checkout未为Git LFS配置认证，需显式处理仓库认证并修正LFS拉取步骤：

pipeline {
    agent {
        dockerfile {
            filename 'Dockerfile'
            additionalBuildArgs '--tag westranger-custom-jdk-21-lts:20240924'
            label 'linux'
        }
    }

    stages {
        stage('Checkout & LFS Pull') {
            steps {
                withCredentials([usernamePassword(credentialsId: 'westranger', 
                                                  usernameVariable: 'USERNAME', 
                                                  passwordVariable: 'PASSWORD')]) {
                    // 重新设置仓库Remote URL，嵌入认证信息
                    sh "git remote set-url origin https://${USERNAME}:${PASSWORD}@bitbucket.org/westranger/my-java-project.git"
                    // 初始化本地LFS配置
                    sh "git lfs install --local"
                    // 拉取LFS对象
                    sh "git lfs pull"
                }
            }
        }
    
        stage('Build') {
            steps {
                sh './mvnw clean install -DskipTests'
            }
        }

        stage('Test') {
            steps {
                sh './mvnw test jacoco:report'
            }
        }
    }
}

• 嵌入认证信息到Remote URL，确保Git LFS能通过HTTPS访问私有仓库
• 移除--skip-repo参数，让LFS正确关联当前仓库的配置规则

3. 调试验证（若问题仍存在） #

在Jenkinsfile中添加调试命令，确认环境配置：

sh "echo \$PATH"
sh "which git-lfs"
sh "git config --list | grep lfs"

通过输出可验证：

• PATH是否包含git-lfs的路径（Alpine镜像中通常为/usr/bin/git-lfs）
• Git的LFS相关配置项（如filter.lfs.clean、filter.lfs.smudge）是否存在

额外注意事项 #

• 若Alpine镜像的Git LFS版本兼容性有问题，可切换到基于Debian的eclipse-temurin:21.0.4_7-jdk镜像，通过apt-get install git git-lfs安装组件
• 确保Jenkins Slave具备正常的Docker权限，且容器能访问外部网络（Bitbucket）

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