Windows控制器+Mac代理环境下Jenkins Pipeline无法初始化Git仓库求助

问题定位 #

从报错日志可以看出，Jenkins执行Git命令时出现路径解析错误：本该调用/usr/bin/git，却误将工作区路径当作可执行文件尝试运行，最终触发权限拒绝。核心原因是全局工具配置中git_mac的Git可执行文件路径配置错误（比如路径填成了工作区路径、末尾多了斜杠等）。

修复步骤 #

1. 修正全局工具配置的Git路径

   • 进入Jenkins后台「Manage Jenkins → Global Tool Configuration」
   • 找到名为git_mac的Git安装项，将Git可执行文件路径改为Mac终端查到的/usr/bin/git，确保路径无多余字符或错误格式
   • 保存配置

2. 优化Pipeline代码（规范写法）
   既然已指定Mac代理节点，无需再判断系统，直接使用git_mac即可，分支写法也可简化：

   pipeline {
       agent {
           label 'mac1'
       }
       stages {
           stage('Checkout') {
               steps {
                   checkout([$class: 'GitSCM', 
                             branches: [[name: 'main']],
                             gitTool: 'git_mac', 
                             userRemoteConfigs: [[credentialsId: 'defaultssh', url: 'git@global.company.gitlab.com:team/team-ci.git']]
                           ])
               }
           }
       }
   }
   

3. 验证代理节点目录权限

   • 确认运行Jenkins代理的用户对/Library/Automation/jenkins/workspace/目录拥有读写权限
   • 可在Mac终端切换到Jenkins代理用户（如su jenkins），手动执行git init /Library/Automation/jenkins/workspace/test_dir测试权限是否正常

4. 备选方案：直接指定Git路径
   如果全局工具配置仍有问题，可在Pipeline中直接指定Git路径，跳过工具配置环节：

   pipeline {
       agent {
           label 'mac1'
       }
       environment {
           GIT_EXECUTABLE = '/usr/bin/git'
       }
       stages {
           stage('Checkout') {
               steps {
                   git branch: 'main',
                       credentialsId: 'defaultssh',
                       url: 'git@global.company.gitlab.com:team/team-ci.git'
               }
           }
       }
   }
   

   通过environment设置GIT_EXECUTABLE，强制Mac代理使用本地Git可执行文件，避免调用Windows控制器的Git。

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