Jenkins流水线执行git pull时含@的密码导致主机解析失败求助

我之前也碰到过一模一样的问题！核心原因是Git会把URL中的@符号当作用户名和主机地址的分隔符，当你的密码里包含@时，直接拼接URL会导致Git把@后面的部分（比如你密码里的hello）当成主机名的一部分，所以才会出现unable to resolve host: 4hello@github.myorg.com这种错误——本质是编码后的%40hello被拆分，@后面的hello被误解析为主机名前缀了。

下面给你三个可行的解决方案，按推荐优先级排序：

1. 优先使用Jenkins内置的Git步骤（最省心可靠） #

Jenkins的git步骤会自动帮你处理凭证的URL编码，完全不需要手动拼接带密码的URL，这是最安全也最不容易出错的方式：

def credId = 'The id of the cred stored in Jenkins credentials'
def repoUrl = 'https://github.myorg.com/myrepo.git'
def myBranch = 'your-branch-name' // 替换成你的实际分支名

stage('Checkout & Pull Latest Code') {
    withCredentials([usernamePassword(credId: credId, passwordVariable: 'GIT_PASSWORD', usernameVariable: 'GIT_USERNAME')]) {
        // Jenkins会自动用凭证拉取指定分支的最新代码
        git branch: myBranch,
            credentialsId: credId,
            url: repoUrl
        
        // 如果需要强制拉取最新代码（默认git步骤已拉取最新，除非有本地修改需要合并）
        sh 'git pull'
    }
}

2. 用Python3对密码进行可靠的URL编码 #

你之前用od+sed的编码方式可能存在兼容性问题，改用Python3的urllib.parse.quote来编码会更稳定（大多数Jenkins节点都预装了Python3）：

def credId = 'The id of the cred stored in Jenkins credentials'
stage('Some Stage'){
    withCredentials([usernamePassword(credId: credId, passwordVariable: 'GIT_PASSWORD', usernameVariable: 'GIT_USERNAME')]){
        sh """
            git checkout ${myBranch}
            git status
            # 用Python3对密码进行URL编码，处理所有特殊字符
            ENCODED_PASSWORD=\$(python3 -c "import urllib.parse; print(urllib.parse.quote('''${GIT_PASSWORD}'''))")
            # 用编码后的密码拼接合法URL
            git pull https://${GIT_USERNAME}:\${ENCODED_PASSWORD}@github.myorg.com/myrepo.git
        """
    }
}

注意这里用了三重引号'''包裹密码，避免密码里的单/双引号破坏Python脚本；同时ENCODED_PASSWORD前面加了\，防止Groovy提前解析变量。

3. 正确配置Git凭证助手 #

如果一定要用手动git命令，也可以通过配置临时凭证助手让Git自动读取密码，不需要拼接带密码的URL：

def credId = 'The id of the cred stored in Jenkins credentials'
stage('Some Stage'){
    withCredentials([usernamePassword(credId: credId, passwordVariable: 'GIT_PASSWORD', usernameVariable: 'GIT_USERNAME')]){
        sh """
            git checkout ${myBranch}
            git status
            # 临时配置本地凭证助手，返回用户名和密码
            git config --local credential.helper '!f() { echo "username=${GIT_USERNAME}"; echo "password=${GIT_PASSWORD}"; }; f'
            # 直接拉取，Git会自动调用凭证助手获取密码
            git pull https://github.myorg.com/myrepo.git
            # 立即清理凭证配置，避免泄露敏感信息
            git config --local --unset credential.helper
        """
    }
}

这里用--local只针对当前仓库配置，不会影响全局设置；执行完pull后一定要清理配置，保证凭证安全。

建议优先尝试方案一，这是Jenkins设计的标准用法，能避免很多手动处理的坑。

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