Spring Boot 3.x升级后Config Server SSH Git代理连接失败求助

核心报错原因 #

你遇到的NullPointerException是因为Spring Cloud 2022.0.x（Kilburn版本）对Git SSH配置结构做了重大调整：

• Spring Boot 2.7.x + Spring Cloud 2021.x及更早版本中，SSH相关配置（如私钥、密码短语）直接放在spring.cloud.config.server.git节点下；
• 升级到Spring Boot 3.x + Spring Cloud 2022.x后，所有SSH属性被迁移到spring.cloud.config.server.git.ssh子节点下。若未更新配置，sshProperties会被初始化为null，调用getPrivateKey()时就会触发NPE。

连接代理而非目标仓库的排查方向 #

报错中显示连接到git@proxy-internet.org/10.X.X.X:XXXX，可能是以下原因：

• 仓库URL格式错误：确认仓库URL是否为正确的SSH格式git@github.com:myOrg/myConfigRepo.git（注意用冒号分隔主机和仓库路径，而非斜杠），格式错误会导致JGit错误解析目标地址。
• 代理配置优先级变化：新版本对代理配置的读取逻辑做了优化，可能自动拾取了系统级Git代理配置（如~/.gitconfig中的[ssh]代理设置），或者应用配置中的代理属性配置有误，导致代理地址被错误识别为仓库主机。
• SSH代理配置错误：如果配置了spring.cloud.config.server.git.ssh.proxy相关属性，检查其格式是否符合新版本要求，避免配置冲突。

修复步骤 #

1. 更新SSH配置结构
   将旧配置：

   # 旧版本（Boot2.x/Cloud2021.x）
   spring.cloud.config.server.git.private-key=你的私钥内容
   spring.cloud.config.server.git.passphrase=你的密码短语（如果有）
   

   修改为新版本格式：

   # 新版本（Boot3.x/Cloud2022.x）
   spring.cloud.config.server.git.ssh.private-key=你的私钥内容
   spring.cloud.config.server.git.ssh.passphrase=你的密码短语（如果有）
   

   若需关闭严格主机密钥检查，同样调整路径：

   spring.cloud.config.server.git.ssh.strict-host-key-checking=false
   

2. 验证仓库URL与代理配置

   • 确认spring.cloud.config.server.git.uri属性正确设置为git@github.com:myOrg/myConfigRepo.git；
   • 检查系统Git全局配置（~/.gitconfig）是否存在不必要的SSH代理设置，如有可临时注释后测试；
   • 若使用应用级代理，确保代理配置属性（如spring.cloud.config.server.git.proxy.host、spring.cloud.config.server.git.proxy.port）正确指向代理服务器，而非仓库地址。

Spring Boot 3 + Spring Cloud 2022.x 重要配置变更 #

• Git SSH配置迁移：所有SSH相关属性从spring.cloud.config.server.git迁移到spring.cloud.config.server.git.ssh子节点，旧属性会被忽略。
• 配置属性重命名：部分安全相关属性被重命名，例如spring.cloud.config.server.git.skip-ssl-validation替换为spring.cloud.config.server.git.ssl.skip-validation。
• 默认行为变更：SSH严格主机密钥检查默认从false改为true，需显式关闭以兼容旧环境。
• 依赖版本强制对齐：Spring Cloud 2022.x要求Spring Boot 3.0.x及以上版本，所有Spring Cloud组件版本需统一，避免依赖冲突。
• Jakarta EE API适配：由于Spring Boot 3切换到Jakarta EE，部分配置绑定的底层逻辑调整，旧的自定义配置绑定代码可能需要修改。

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