Azure App Service Java应用HTTPS访问同VNet Apache私网IP报SAN错误的解决
问题根因前置说明
你遇到的No subject alternative names present报错,本质是Java客户端在TLS握手阶段校验服务端证书时,发现当前访问的目标地址(私网IP)没有被纳入证书的SAN(主体可选名称)列表,因此主动中断连接。
此前尝试的方案无效的核心原因:
- 配置的
-Dcom.sun.jndi.ldap.object.disableEndpointIdentification=true仅作用于Java JNDI模块的LDAP连接校验逻辑,和Spring Web客户端(RestTemplate、WebClient等)的HTTPS TLS校验流程完全独立,对HTTP请求的SSL握手没有任何影响 - 修改App Service本地hosts的方案存在固有缺陷:App Service的应用实例文件系统是临时的、多实例相互隔离的,手动修改的hosts配置会在应用重启、扩缩容后丢失,无法长期生效
符合约束的可落地方案
方案1:基于VNet私有DNS的透明域名映射(推荐,零侵入)
该方案完全满足“不修改Java应用代码、不调整Apache侧SSL证书配置”的要求,操作逻辑如下:
- 在与Azure App Service集成的VNet中,创建对应Apache服务原有可正常访问的公网域名的私有DNS区域(即Apache现有SSL证书上登记的、带有效SAN的域名)
- 在该私有DNS区域中添加一条A记录,将这个绑定了证书的公网域名直接解析到Apache服务对应的私网IP
- Java应用的访问地址保持为原本的带有效SAN的域名即可,不再使用私网IP作为访问路径
方案实际效果: - 所有访问Apache的流量完全在VNet私网内流转,不走公网链路
- TLS握手阶段,客户端访问的域名完全匹配证书上登记的SAN字段,从根源上避免域名不匹配的SSL报错
- 整个流程不需要改动Apache侧的任何SSL配置、虚拟主机配置,也不需要修改Java应用的业务代码,所有DNS配置在VNet层面透明生效,不受App Service实例扩缩容、重启的影响
方案2:通过JVM参数调整SSL校验规则(临时调试场景适用)
如果存在短期场景无法调整DNS配置,可在Azure App Service的应用设置中配置全局JAVA_OPTS参数,调整JSSE层面的证书校验逻辑,跳过主机名匹配环节。注意区分此前误用的LDAP专用参数,需根据自身使用的Java版本匹配对应的JSSE全局配置项。
该方案的局限性:
- 会放宽整个JVM进程所有HTTPS连接的校验规则,存在一定安全风险
- 不同Java版本支持的全局校验跳过参数存在差异,需要匹配对应版本的配置要求,仅建议在内部私网环境临时调试使用,不适合长期生产环境运行
内容的提问来源于stack exchange,提问作者itadvice887
相关产品推荐
相关产品推荐

