JSch在z/OS上连接localhost时提示无效密钥问题排查

针对你在z/OS上运行SpringBoot应用时遇到的JSch私钥无效问题，结合你已排查过权限、命令行SSH正常的情况，给出几个针对性的排查方向：

• 私钥格式兼容性问题
  JSch对OpenSSH新格式的私钥（比如以-----BEGIN OPENSSH PRIVATE KEY-----开头的）支持有限，即便本地能正常解析，z/OS环境下可能出现兼容性问题。可以把私钥转换为传统PEM格式试试：

  ssh-keygen -p -m PEM -f /path/to/private_key
  

  转换后替换原私钥，重新测试应用。

• z/OS字符编码干扰
  z/OS默认用EBCDIC编码，而私钥是ASCII格式。如果JSch读取文件时用了EBCDIC编码解析，会直接导致格式错误。可以从两方面处理：

  1. 给私钥文件设置ASCII标签，确保z/OS正确识别编码：

     chtag -t -c ISO8859-1 /path/to/private_key
     

  2. 在代码里读取私钥时强制指定ASCII编码：

     byte[] keyBytes = Files.readAllBytes(Paths.get("/path/to/private_key"));
     String privateKeyStr = new String(keyBytes, StandardCharsets.US_ASCII);
     jSch.addIdentity("service-id-key", privateKeyStr.getBytes(StandardCharsets.US_ASCII), null, null);
     

• JSch版本适配问题
  旧版本JSch对z/OS环境的支持存在缺陷，建议升级到最新稳定版（比如0.1.55及以上），替换项目中的JSch依赖后重新打包测试。

• 换行符格式问题
  z/OS的换行符是EBCDIC的NL（0x15），而私钥文件需要的是UNIX风格的LF（0x0A）。如果私钥传输到z/OS时换行符被转换，会导致JSch解析失败。可以用cat -v /path/to/private_key查看换行符，若显示^M或其他异常字符，用z/OS上的转换工具（比如iconv）调整为UNIX换行格式。

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