【Java】已解决：javax.net.ssl.SSLHandshakeException: SSL

屿小夏

已于 2024-09-21 12:53:32 修改

阅读量1.6k

点赞数 8

文章标签： java .net ssl

于 2024-09-12 09:46:57 首次发布

本文链接：https://blog.csdn.net/a1657054242/article/details/141129828

版权

个人简介：某不知名博主，致力于全栈领域的优质博客分享 | 用最优质的内容带来最舒适的阅读体验！文末获取免费IT学习资料！

🍅 文末获取更多信息 🍅 👇🏻 精彩专栏推荐订阅收藏 👇🏻

专栏系列	直达链接	相关介绍
书籍分享	点我跳转	书籍作为获取知识的重要途径，对于IT从业者来说更是不可或缺的资源。不定期更新IT图书，并在评论区抽取随机粉丝，书籍免费包邮到家
AI前沿	点我跳转	探讨人工智能技术领域的最新发展和创新，涵盖机器学习、深度学习、自然语言处理、计算机视觉等领域的研究进展和趋势分析。通过深入解读前沿技术、案例研究和行业动向，为读者带来关于人工智能未来发展方向和应用前景的洞察和启发。
Elasticsearch	点我跳转	详解 Elasticsearch 搜索和数据分析引擎
科技前沿	点我跳转	本档是关于科技和互联网的专栏，旨在为读者提供有趣、有用、有深度的科技资讯和思考。从多个角度探讨科技与人类生活的关系，包括但不限于科技趋势、产品评测、技术解读、行业观察、创业故事等内容。希望通过本栏，与读者分享科技的魅力和思考，让科技成为我们生活的一部分，而不仅仅是一个陌生的词汇。
Java之光	点我跳转	本栏将带领读者深入探索Java编程世界的种种奥秘。无论你是初学者还是资深开发者，这里都将为你提供丰富的Java知识和实用的编程技巧。
Linux学习日志	点我跳转	本专栏致力于探索Linux操作系统的各个方面，包括基础知识、系统管理、网络配置、安全性等。通过深入浅出的文章和实践指南，帮助读者更好地理解和应用Linux，提高系统管理和开发技能。无论你是初学者还是有经验的Linux用户，都能在本专栏中找到有用的信息和解决方案。
MySQL之旅	点我跳转	专栏将带领读者进入MySQL数据库的世界，探索其强大的功能和应用。我们将深入探讨MySQL的基本概念、SQL语言的应用、数据库设计与优化、数据备份与恢复等方面的知识，并结合实际案例进行讲解和实践操作。
精通Python百日计划	点我跳转	我们将引领你踏上一段为期100天的编程之旅，逐步深入了解和掌握Python编程语言。无论你是编程新手还是有一定基础的开发者，这个专栏都会为你提供系统而全面的学习路径，帮助你在短短100天内成为Python高手。

文章目录

在Java开发过程中，SSL（Secure Sockets Layer）握手异常是一个常见的网络通信错误，特别是在使用HTTPS协议进行安全通信时。本文将详细分析javax.net.ssl.SSLHandshakeException: SSL这一异常的背景、可能的原因，并通过代码示例帮助您理解和解决这一问题。

一、分析问题背景

javax.net.ssl.SSLHandshakeException是一种在SSL/TLS握手过程中发生的异常，通常在客户端和服务器之间建立安全连接时出现。SSL握手是确保双方通信安全的关键步骤，其中包括验证证书、协商加密算法和生成对称密钥。如果在这个过程中出现任何问题，例如证书无效或不被信任、协议版本不匹配等，就会导致SSL握手失败，从而抛出SSLHandshakeException。

场景示例

假设我们在Java应用中尝试通过HTTPS请求访问一个API：

URL url = new URL("https://example.com/api");
HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
connection.setRequestMethod("GET");
InputStream response = connection.getInputStream();

如果服务器的SSL证书不被客户端信任，或证书存在问题，运行上述代码时就会抛出SSLHandshakeException。

二、可能出错的原因

导致javax.net.ssl.SSLHandshakeException的原因主要包括以下几种：

证书问题：服务器端提供的SSL证书未被客户端信任。可能是因为证书是自签名的，或者客户端缺少该证书的受信任根证书。
协议不匹配：客户端和服务器支持的SSL/TLS协议版本不兼容。比如服务器只支持TLSv1.2，而客户端尝试使用TLSv1.3。
证书过期：服务器证书已过期或尚未生效，导致SSL握手失败。
证书配置错误：服务器配置错误，未正确安装或配置SSL证书，导致客户端无法成功进行握手。
中间人攻击：在某些情况下，SSL握手失败可能是由于中间人攻击，导致客户端收到伪造的证书。

三、错误代码示例

下面提供一个可能导致SSLHandshakeException的代码示例：

import javax.net.ssl.HttpsURLConnection;
import java.io.InputStream;
import java.net.URL;

public class SSLHandshakeExample {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://self-signed.badssl.com/");
            HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
            connection.setRequestMethod("GET");
            InputStream response = connection.getInputStream();
            // 处理响应
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

错误分析

在这个示例中，客户端试图访问一个使用自签名证书的服务器https://self-signed.badssl.com/。由于自签名证书未被信任，SSL握手过程中会抛出SSLHandshakeException，并且连接将无法建立。

四、正确代码示例

为了解决SSLHandshakeException，我们可以选择以下几种方法：

信任自签名证书：在开发或测试环境中，您可以通过配置SSL上下文信任所有证书（包括自签名证书）。但请注意，这种方法仅适用于非生产环境，因为它会降低安全性。

import javax.net.ssl.*;
import java.io.InputStream;
import java.net.URL;
import java.security.cert.X509Certificate;

public class SSLHandshakeSolution {
    public static void main(String[] args) {
        try {
            // 创建一个信任管理器，信任所有证书
            TrustManager[] trustAllCerts = new TrustManager[]{
                new X509TrustManager() {
                    public X509Certificate[] getAcceptedIssuers() {
                        return null;
                    }

                    public void checkClientTrusted(X509Certificate[] certs, String authType) {
                    }

                    public void checkServerTrusted(X509Certificate[] certs, String authType) {
                    }
                }
            };

            // 安装全局的信任管理器
            SSLContext sc = SSLContext.getInstance("TLS");
            sc.init(null, trustAllCerts, new java.security.SecureRandom());
            HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());

            // 进行HTTPS请求
            URL url = new URL("https://self-signed.badssl.com/");
            HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
            connection.setRequestMethod("GET");
            InputStream response = connection.getInputStream();
            // 处理响应
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

更新信任库：在生产环境中，您应当将服务器的证书添加到客户端的信任库中，以确保SSL握手的安全性。

# 使用keytool将服务器证书导入客户端信任库
keytool -import -alias example -file server-cert.pem -keystore cacerts

启用兼容的TLS版本：如果是由于协议版本不匹配，可以显式指定客户端支持的TLS版本。

HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
connection.setSSLSocketFactory(SSLSocketFactory.getDefault());
// 确保使用兼容的TLS版本
connection.setEnabledProtocols(new String[]{"TLSv1.2", "TLSv1.3"});