Spring Cloud Config Server连接Bitbucket报invalidPrivateKey问题求助

Hey，我来帮你搞定这个困扰你的invalidPrivateKey异常！针对你的两个问题，我给你详细拆解一下：

1. application.yml/.properties中配置私钥的特定格式要求 #

不管用哪种配置文件，核心要求是让Spring能正确识别完整的PEM格式私钥，这里分两种文件类型说明：

• YAML文件（.yml）：
  推荐用块字符串格式（用|开头）来保留私钥的所有换行，这是最不容易出错的方式。同时要开启ignore-local-ssh-settings: true，避免Spring自动读取本地SSH配置，强制使用你配置的私钥。示例配置：

  spring:
    cloud:
      config:
        server:
          git:
            uri: git@bitbucket.org:你的用户名/你的仓库.git
            ignore-local-ssh-settings: true
            private-key: |
              -----BEGIN RSA PRIVATE KEY-----
              MIIEpAIBAAKCAQEAzXt...（这里保留私钥的所有原始换行和内容）
              ...
              -----END RSA PRIVATE KEY-----
  

  注意：私钥必须是未加密的PEM格式（ssh-keygen默认生成的就是这种，如果你生成时设置了密码，需要额外配置passphrase，或者重新生成无密码的密钥对）。

• Properties文件（.properties）：
  基本要求和yml一致，但需要处理换行问题（下面第二个问题会详细说），同样要确保私钥是完整的PEM格式，且开启ignore-local-ssh-settings=true。

2. .properties文件中多行私钥转单行的方法 #

Properties不支持直接换行，所以需要把私钥里的每一个换行替换成\n，并且用双引号把整个私钥内容包裹起来，这样Spring才能正确解析转义字符。具体步骤：

1. 打开你的私钥文件，复制所有内容（包括开头的-----BEGIN RSA PRIVATE KEY-----和结尾的-----END RSA PRIVATE KEY-----）。
2. 把内容里的每一个换行符替换成\n。
3. 把处理后的内容用双引号括起来，放到properties配置项中。

示例配置：

spring.cloud.config.server.git.uri=git@bitbucket.org:你的用户名/你的仓库.git
spring.cloud.config.server.git.ignore-local-ssh-settings=true
spring.cloud.config.server.git.private-key="-----BEGIN RSA PRIVATE KEY-----\nMIIEpAIBAAKCAQEAzXt...\n...\n-----END RSA PRIVATE KEY-----"

额外排查小提示 #

• 确认你复制的私钥完整无缺，有没有漏掉开头或结尾的标识行，或者中间的字符。
• 检查Bitbucket里的公钥配置：确保你上传的是.pub文件的全部内容，包括结尾的用户名@主机名部分。
• 如果用的是ED25519格式的密钥，部分旧版本的Spring Cloud Config对其支持不佳，可以尝试换成RSA格式的密钥（ssh-keygen默认就是RSA），或者升级Spring Boot/Spring Cloud到较新的版本。

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