使用Apache HttpClient 4.5.3调用reCAPTCHA接口报SSL证书不匹配问题
问题根本原因
- 本次抛出的
javax.net.ssl.SSLPeerUnverifiedException本质是SSL主机名校验失败,整个报错流程完全符合框架内置的安全设计,不存在HttpClient配置层面的错误:
- 代码中填写的请求目标域名
www.recaptcha.com并非reCAPTCHA siteverify接口的实际服务域名,该接口的实际服务属于Google主域体系。 - 请求发起时,
www.recaptcha.com的DNS解析结果指向Google旗下服务节点,节点返回的TLS证书是Google全业务通用证书,该证书的SAN(主题备用名称)列表仅覆盖所有Google关联业务域名,列表中不包含www.recaptcha.com。 - 从异常堆栈可以看到,报错触发点正是
org.apache.http.conn.ssl.SSLConnectionSocketFactory类下的verifyHostname校验方法——这是Apache HttpClient内置的安全逻辑,会在TLS握手完成后自动执行主机名匹配:将请求的目标域名和服务端返回证书的SAN列表逐一比对,只要域名不在合法匹配范围内,就会直接中断连接抛出该异常,避免遭受中间人攻击。
- 注意事项:不要为了绕过这个错误直接关闭HttpClient的主机名校验逻辑,否则会引入严重安全风险,正确的修复方向是将请求地址替换为接口实际对应的正确域名。
内容的提问来源于stack exchange,提问作者eastwater
相关产品推荐
相关产品推荐

