Spring Cloud 2021.0.4 Config Server无法访问GitHub仓库：私钥验证失败

问题场景 #

将Spring Cloud从2021.0.3升级至2021.0.4后，Config Server启动时抛出如下绑定错误：

Binding to target org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'spring.cloud.config.server.git' to org.springframework.cloud.config.server.environment.MultipleJGitEnvironmentProperties failed:

Reason: Property 'spring.cloud.config.server.git.privateKey' is not a valid private key

配置未做任何修改，仅升级了Spring Cloud版本。

原因分析 #

Spring Cloud Config Server 2021.0.4版本（Jubilee SR4）加强了RSA私钥的格式校验逻辑，之前版本允许的非标准格式（比如缩进不一致、换行缺失、Base64编码不规范等），现在会被严格判定为无效私钥。

解决方案 #

1. 修正私钥格式与YAML缩进 #

YAML中使用|保留换行时，私钥内容的缩进必须完全统一，且私钥本身需符合标准PKCS#1格式：

spring:
  cloud:
    config:
      server:
        git:
          # 其他配置项...
          private-key: |
            -----BEGIN RSA PRIVATE KEY-----
            xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
            # 确保每一行Base64编码长度符合标准（通常64字符）
            xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
            -----END RSA PRIVATE KEY-----

• 私钥的开头、结尾标记必须单独占一行，前后无多余空格或字符
• 所有私钥主体行的缩进需与private-key: |下一行的缩进完全一致
• 私钥结尾标记后不能有多余换行或内容

2. 验证私钥本身有效性 #

将配置中的私钥复制到本地文件（如temp_rsa），通过OpenSSL命令校验：

openssl rsa -check -in temp_rsa

若返回RSA key ok则私钥本身有效；若报错，需重新生成或修复私钥（确保是未损坏的RSA私钥）。

3. 清理冗余配置 #

• 如果你的私钥未设置密码，直接删除passphrase: xxxxxxx配置项，避免校验冲突
• 若私钥有密码，确保passphrase配置与私钥密码完全匹配

4. 临时应急方案（不推荐长期使用） #

若需快速恢复服务，可临时关闭私钥严格校验：

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

注意：此方案仅用于应急，长期需修复私钥格式问题以保障安全。

内容的提问来源于stack exchange，提问作者J. Hu