Git for Windows 在 Jenkins 环境下 SSH 推送失败问题分析

问题现象

在 Windows Server 2022 环境中，当通过 Jenkins 的 SSH 代理执行 Git 推送操作时，系统报错显示无法识别 SSH 版本字符串为有效命令。具体表现为执行 git push 命令时，错误信息显示类似"'SSH-2.0-OpenSSH_9.6' is not recognized as an internal or external command"。

环境配置

• Git for Windows 版本：2.44.0.windows.1 (64位)
• 操作系统：Windows Server 2022 (10.0.20348.2340)
• 安装选项：使用 OpenSSH 作为 SSH 实现，路径选项设置为 Cmd，启用了凭据管理器

问题根源分析

1. SSH 执行路径问题：当 Git 尝试执行 SSH 命令时，系统未能正确找到 Git 自带的 ssh.exe 可执行文件，而是错误地将 SSH 协议版本字符串当作命令执行。

2. 环境差异：问题仅在 Jenkins 环境下出现，直接用户执行时正常，表明 Jenkins 环境可能修改了 PATH 环境变量或影响了命令查找机制。

3. SSH 命令解析异常：错误信息中出现的 SSH 版本字符串通常是 SSH 服务器返回的协议标识，正常情况下不应被当作命令执行。

诊断方法

1. 配置检查：通过 git config -l 检查核心配置，特别是 core.sshCommand 是否被设置。

2. 跟踪执行：使用 GIT_TRACE=1 和 GIT_TRACE2_PERF=1 环境变量获取详细执行日志。

3. 路径验证：检查 Jenkins 环境下的 PATH 变量，确认 Git 的安装路径是否包含在其中。

解决方案建议

1. 显式指定 SSH 路径：在 Git 配置中明确设置 core.sshCommand 为 Git 安装目录下的 ssh.exe 完整路径。

2. 环境隔离检查：比较 Jenkins 环境和普通用户环境下的 PATH 变量差异，确保 Git 的二进制目录在 PATH 中。

3. SSH 认证配置：确认 SSH 密钥认证配置在 Jenkins 环境下是否可用，可能需要重新配置凭据。

4. 自定义包装脚本：创建一个包装脚本，先输出环境信息（如 PATH 内容、ssh 命令位置等），再转发 SSH 调用，帮助诊断问题。

技术要点

• Git for Windows 默认使用自带的 OpenSSH 实现进行 SSH 操作
• Jenkins 环境可能修改或限制某些环境变量
• SSH 协议协商过程中的版本字符串不应被当作命令执行
• 跨环境执行时，PATH 解析和命令查找机制可能表现不同

预防措施

1. 在 CI/CD 环境中，建议显式配置所有必要的路径和命令位置
2. 使用绝对路径引用关键工具，避免依赖环境变量
3. 在构建脚本中加入环境检查步骤，提前发现问题
4. 考虑使用 Git 的 HTTPS 协议替代 SSH，减少环境依赖

通过以上分析和解决方案，可以系统性地解决 Git for Windows 在 Jenkins 环境下 SSH 推送失败的问题，并建立更健壮的持续集成环境配置。