Jenkins Pipeline远程SSH执行命令卡住问题求助

我之前踩过Jenkins SSH Pipeline卡住的坑，结合你的情况——连执行pwd都会卡住，大概率是这几个常见原因，你可以挨个排查：

1. SSH会话未正常结束，输出流未被正确处理 #

很多时候Jenkins的SSH连接卡住，是因为远程命令执行后，会话没有主动关闭，或者stdout/stderr输出流没有被完全消费。哪怕是pwd这种简单命令，如果SSH客户端一直在等待后续输出，就会挂起。

解决方法：

• 如果你用的是Jenkins SSH Pipeline Steps插件的sshCommand，可以尝试用bash -c包裹命令，确保一次性执行并退出：

  sshCommand remote: remote, command: 'bash -c "pwd; exit"'
  

• 也可以尝试关闭pty参数（有些场景下分配伪终端会导致会话挂起）：

  sshCommand remote: remote, command: 'pwd', pty: false
  

2. TTY分配问题导致会话等待交互 #

部分远程服务器的SSH配置会要求分配TTY（伪终端），但Jenkins默认的SSH连接可能没分配，导致会话卡在等待TTY的状态；反过来，强制分配TTY后，如果没有后续输入，也可能挂起。

解决方法：

• 如果是直接用ssh命令行工具（而非Jenkins插件），加上-T参数禁用TTY分配：

  sh 'ssh -T -i /path/to/private-key user@your-server "pwd"'
  

• 用SSH插件时，尝试切换pty参数的开启/关闭状态，看是否能解决。

3. 远程服务器的用户启动脚本有交互式内容 #

这是很容易忽略的点：远程服务器上目标用户的.bashrc、.bash_profile或.profile里，可能有需要用户交互的代码（比如询问是否接受证书、显示需要确认的提示、甚至是read命令），这些内容会让SSH会话卡住等待输入，而Jenkins是非交互式的，不会处理这些输入。

解决方法：

• 手动在Jenkins服务器上，用Jenkins运行的用户（比如jenkins用户）执行ssh user@your-server pwd，看看会不会卡住，以此确认是不是远程环境的问题。
• 修改远程服务器上的启动脚本，把交互式内容放到仅交互式会话才执行的分支里，比如：

  # 在.bashrc里添加判断
  if [[ $- == *i* ]]; then
      # 这里放只有交互式会话才需要执行的内容，比如欢迎语、询问操作等
  fi
  

4. Jenkins SSH插件版本存在bug #

旧版本的SSH Pipeline插件可能存在会话无法正常终止的bug，尤其是在处理简单命令时。

解决方法：

• 进入Jenkins的插件管理页面，找到SSH Pipeline Steps插件，升级到最新的稳定版本，然后重试任务。

给你一个经过验证的简易Pipeline示例，你可以参考：

pipeline {
    agent any
    stages {
        stage('Test SSH Connection') {
            steps {
                script {
                    // 配置远程服务器信息
                    def remoteServer = [:]
                    remoteServer.name = 'MyRemoteServer'
                    remoteServer.host = '192.168.1.100' // 替换成你的服务器IP
                    remoteServer.user = 'deploy' // 替换成你的用户名
                    remoteServer.identityFile = '/var/lib/jenkins/.ssh/id_rsa' // Jenkins用户的私钥路径
                    remoteServer.allowAnyHosts = true

                    // 执行pwd命令，确保会话正常结束
                    sshCommand remote: remoteServer, command: 'pwd', pty: false
                }
            }
        }
    }
}

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