使用HttpsURLConnection连接HTTPS服务触发SSLHandshakeException的问题咨询
SSL握手"No subject alternative names present"报错原因与修正方案
报错核心原因
抛出该异常的本质是Java客户端在完成服务端证书信任校验后,主机名匹配校验环节失败:
从Java 6版本开始,JDK默认废弃了通过证书CN(通用名)字段匹配访问地址的旧规则,要求服务端的X509证书必须在SAN(Subject Alternative Name,主体备用名)字段中,显式配置和访问地址完全匹配的条目(支持域名、IP两种类型)。当证书中不存在匹配的SAN条目时,就会抛出"No subject alternative names present"的异常,直接中断SSL握手流程。
当前代码的常见问题点
结合贴出的实现片段,有两个会直接触发报错的问题:
- 实际通过IP地址
10.200.104.97访问HTTPS服务,但服务端签发的证书没有在SAN字段中添加这个IP条目 - 代码里独立创建
SSLSocket执行握手的逻辑完全无效:创建出来的socket实例没有被绑定到当前的HttpsURLConnection连接流程中,实际发起请求时走的还是默认的SSL校验逻辑,这段冗余代码不会对连接行为产生任何影响
正确修正步骤
生产环境合规方案(优先选择)
- 重新为服务端签发符合规范的SSL证书:如果通过IP访问服务,需要在证书的SAN字段中添加对应IP条目;如果通过域名访问,需要添加对应域名条目,替换服务端现有证书后重启服务
- 将重新签发的正规证书导入客户端配置的
ssl_truststore文件中,替代原有不受信任的证书 - 删除代码中独立创建
SSLSocket、单独执行握手的冗余逻辑,保持JDK默认的SSL校验流程即可
内网测试临时适配方案(仅限内部环境使用,严禁用于生产)
如果暂时无法调整服务端证书配置,可以通过自定义主机名校验规则完成适配,禁止直接实现信任所有证书的危险逻辑:
- 保留现有的truststore配置逻辑,完成对服务端证书的信任基础校验
- 实现匹配实际访问IP/域名的自定义
HostnameVerifier - 调用
httpURLConnection.setHostnameVerifier(自定义校验器实例)将校验规则绑定到当前连接 - 移除代码中独立创建
SSLSocket的冗余逻辑
内容的提问来源于stack exchange,提问作者Pash0002
相关产品推荐
相关产品推荐

