使用SecureAS400类遇Received fatal alert: protocol_version问题求助

1. 错误与TLS版本的关联性 #

这个错误确实大概率和TLS版本不匹配有关。SecureAS400依赖SSL/TLS加密握手建立连接，当应用端支持的TLS版本和AS400服务器端启用的版本无重叠时，就会握手失败抛出该错误。而非SSL的AS400类无需加密校验，因此能正常运行。

2. 两端版本信息的查看方法 #

应用端（JT400 + JVM） #

• JT400版本对应默认TLS支持：
  • JT400.731：适配IBM i 7.3，默认仅支持TLS 1.0/1.1，对高版本TLS支持有限
  • JT400.78：适配IBM i 7.8，原生支持TLS 1.2及以上，但最终生效版本由JVM配置决定
• 查看JVM启用的TLS版本：
  启动应用时添加JVM参数-Djavax.net.debug=ssl:handshake，运行SecureAS400连接代码，在日志的ClientHello阶段找到Protocol Version字段，即可看到应用端发起的TLS版本。

AS400服务器端（IBM i 7.3） #

• 查看系统SSL/TLS协议配置：
  1. 进入IBM i命令行，执行命令WRKCERTCCS（工作证书存储）
  2. 选择对应证书存储（通常为*SYSTEM），按F11查看详情，找到「协议版本」相关配置项
  3. 或执行STRQSH进入shell，运行openssl s_client -connect <AS400_IP>:448（替换为实际服务器IP），从返回结果中提取服务器支持的TLS版本

3. 修复建议 #

• 若AS400仅启用TLS 1.0/1.1，而JVM默认禁用了这些旧版本（如Java 8u301+默认禁用），需在应用启动参数中添加：

  -Djdk.tls.client.protocols=TLSv1,TLSv1.1,TLSv1.2
  

• 若AS400支持TLS 1.2，建议升级JT400到IBM i 7.3适配的稳定补丁版，同时确保JVM启用TLS 1.2
• 检查AS400端口与协议的绑定关系：确认448等SSL端口是否关联了正确的TLS版本配置，避免端口与协议不匹配

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